Files
tradecatlabs f1f0b9fe75 refactor: move research domain to repository root (#58)
Move the complete research domain from docs/research to root-level research, update indexes and path-aware tooling, and align raw snapshot governance and CODEOWNERS.\n\nVerified with make test and GitHub CI.
2026-07-11 22:18:37 +08:00

2.7 KiB

datawhalechina/vibe-vibe 研究分析

本轮结论

datawhalechina/vibe-vibe 的核心价值是把零基础 Vibe Coding 讲成“能学、能看、能部署、能演示”的课程。 它用 docs/demos/、Docker 和部署说明降低学习门槛,强调从概念走向可见产物。

本仓最应该迁移的是 demo 驱动学习:概念文档必须有验证层,否则用户读完只有认知,没有交付感。

本地证据

  • 研究对象:datawhalechina/vibe-vibe
  • 当前研究角色:中文零基础系统教程
  • 原始仓库:raw/repository/
  • 原始来源清单:raw/sources.yml
  • 事实摘要:domain.yml
  • 深度证据:deep-dive.md

对标拆解

内容
参考对象 datawhalechina/vibe-vibe
它解决的核心问题 让零基础用户从理解 Vibe Coding 走到运行示例和部署体验
核心机制 docs/ 讲解、demos/ 示例、Docker 私有化部署、清晰课程定位
真正带来结果的动作 用可运行 demo 把抽象概念落成体验
可迁移做法 getting-started 增加最小 demo、部署感和阶段产出
不可迁移条件 不把零基础教程简化为工程标准,不复制课程站点体量
下一步试用动作 为一个核心概念补最小练习或 demo 验证任务

改良迭代

改良目标 原模式 本仓版本 验证指标
概念可验证 demo 目录承接教程 concepts 后接 practice / workflow 验证 读者能运行或检查一个结果
部署感 Docker 私有化部署 本仓给出知识库/项目交付的最小上线路径 用户知道如何从本地到可访问产物
零基础解释 先讲清概念和体验 getting-started 降低术语密度 非程序员能理解第一步

可迁移清单

  • 每条新手路径至少配一个可验证产物。
  • 把 demo / assignment 作为概念验收层。
  • 在入门文档里强调“交付感”,不要只讲工具安装。
  • 将部署或发布作为早期可选路线。

不可迁移清单

  • 不把零基础简化表达当作高级工程规范。
  • 不复制 Docker/站点结构作为本仓必需能力。
  • 不把 demo 数量当作质量。

验证动作

动作 成功信号 失败信号
为一个概念补最小练习 用户能完成并验证结果 练习只是阅读题
给新手路径补第一个可见产物 新手知道第一天做出什么 路线仍停在安装工具
抽样检查 demo 与文档一致 demo 能解释对应概念 demo 与正文脱节

沉淀判断

  • 稳定结论进入 docs/getting-started/,后续可考虑独立 practice 层。
  • 本研究域保持 P2 零基础课程对标对象。