mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-24 00:08:06 +00:00
docs: make research domains actionable
- add research transfer synthesis with full 17-domain migration matrix - upgrade all research domain analysis files to actionable benchmark/iteration/validation structure - update research governance, README indexes, metadata, llms, and AI citation entries Validation: - make sync-doc-toc - make test - git diff --check - section coverage check for all 17 docs/research/*/analysis.md files Note: - welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
@@ -2,43 +2,62 @@
|
||||
|
||||
## 本轮结论
|
||||
|
||||
- Vibe Vibe 是面向零基础用户的中文 AI 编程指南,核心价值是把 Vibe Coding 讲成可学习、可部署、可演示的课程。
|
||||
- 仓库包含 `docs/`、`demos/`、`Dockerfile`、`docker-compose.yml`,说明它强调教程、示例和私有化部署。
|
||||
- 本仓应吸收它对零基础用户的解释方式和 demo 驱动学习路径,但工程治理层仍需本仓自己定义。
|
||||
`datawhalechina/vibe-vibe` 的核心价值是把零基础 Vibe Coding 讲成“能学、能看、能部署、能演示”的课程。
|
||||
它用 `docs/`、`demos/`、Docker 和部署说明降低学习门槛,强调从概念走向可见产物。
|
||||
|
||||
本仓最应该迁移的是 demo 驱动学习:概念文档必须有验证层,否则用户读完只有认知,没有交付感。
|
||||
|
||||
## 本地证据
|
||||
|
||||
- 研究对象:`datawhalechina/vibe-vibe`
|
||||
- 当前研究角色:中文零基础系统教程
|
||||
- 本轮成熟度:L1 初步理解
|
||||
- 原始仓库:`raw/repository/`
|
||||
- 原始来源清单:`raw/sources.yml`
|
||||
- 事实摘要:`domain.yml`
|
||||
- 深度证据:`deep-dive.md`
|
||||
|
||||
## 结构观察
|
||||
## 对标拆解
|
||||
|
||||
- 根目录包含 `docs/`、`demos/`、`package.json`、`pnpm-lock.yaml`、`Dockerfile`、`docker-compose.yml`。
|
||||
- README 的核心理念、快速开始、私有化部署、教程定位、进阶版预告和学习产出结构清晰。
|
||||
- 课程形态比工具实现更强,适合作为 onboarding 研究对象。
|
||||
| 项 | 内容 |
|
||||
|:---|:---|
|
||||
| 参考对象 | `datawhalechina/vibe-vibe` |
|
||||
| 它解决的核心问题 | 让零基础用户从理解 Vibe Coding 走到运行示例和部署体验 |
|
||||
| 核心机制 | `docs/` 讲解、`demos/` 示例、Docker 私有化部署、清晰课程定位 |
|
||||
| 真正带来结果的动作 | 用可运行 demo 把抽象概念落成体验 |
|
||||
| 可迁移做法 | getting-started 增加最小 demo、部署感和阶段产出 |
|
||||
| 不可迁移条件 | 不把零基础教程简化为工程标准,不复制课程站点体量 |
|
||||
| 下一步试用动作 | 为一个核心概念补最小练习或 demo 验证任务 |
|
||||
|
||||
## 可借鉴点
|
||||
## 改良迭代
|
||||
|
||||
- 零基础内容需要先给学习产出,再给工具和概念。
|
||||
- demo 目录能降低抽象教程的理解成本。
|
||||
- 私有化部署说明适合补充本仓“教程站点/知识库发布”参考。
|
||||
| 改良目标 | 原模式 | 本仓版本 | 验证指标 |
|
||||
|:---|:---|:---|:---|
|
||||
| 概念可验证 | demo 目录承接教程 | concepts 后接 practice / workflow 验证 | 读者能运行或检查一个结果 |
|
||||
| 部署感 | Docker 私有化部署 | 本仓给出知识库/项目交付的最小上线路径 | 用户知道如何从本地到可访问产物 |
|
||||
| 零基础解释 | 先讲清概念和体验 | getting-started 降低术语密度 | 非程序员能理解第一步 |
|
||||
|
||||
## 风险和边界
|
||||
## 可迁移清单
|
||||
|
||||
- 面向零基础会简化工程细节,不能直接当作高级工程规范。
|
||||
- 大体量课程仓库需要区分原创内容、站点框架和生成资产。
|
||||
- 进阶版能力需要继续观察是否真实落地。
|
||||
- 每条新手路径至少配一个可验证产物。
|
||||
- 把 demo / assignment 作为概念验收层。
|
||||
- 在入门文档里强调“交付感”,不要只讲工具安装。
|
||||
- 将部署或发布作为早期可选路线。
|
||||
|
||||
## 下一轮研究任务
|
||||
## 不可迁移清单
|
||||
|
||||
- 整理它的课程目录和 demo 类型,对照本仓 getting-started。
|
||||
- 分析私有化部署部分是否能沉淀到 references。
|
||||
- 不把零基础简化表达当作高级工程规范。
|
||||
- 不复制 Docker/站点结构作为本仓必需能力。
|
||||
- 不把 demo 数量当作质量。
|
||||
|
||||
## 验证动作
|
||||
|
||||
| 动作 | 成功信号 | 失败信号 |
|
||||
|:---|:---|:---|
|
||||
| 为一个概念补最小练习 | 用户能完成并验证结果 | 练习只是阅读题 |
|
||||
| 给新手路径补第一个可见产物 | 新手知道第一天做出什么 | 路线仍停在安装工具 |
|
||||
| 抽样检查 demo 与文档一致 | demo 能解释对应概念 | demo 与正文脱节 |
|
||||
|
||||
## 沉淀判断
|
||||
|
||||
- 本轮只完成 L1 理解,不直接迁入 concepts、references、workflow 或 skills。
|
||||
- 只有经过 L2 源码阅读、实验验证或交叉对照后的结论,才进入稳定层。
|
||||
- 稳定结论进入 `docs/getting-started/`,后续可考虑独立 practice 层。
|
||||
- 本研究域保持 P2 零基础课程对标对象。
|
||||
|
||||
Reference in New Issue
Block a user