从"感觉式编程"到"工程化开发" — 让 AI 编程助手按工程纪律干活

这是一个面向 AI 辅助编程教学的项目模板，内嵌 10 个软件工程技能（改编自 Superpowers 框架），通过三个项目模块带你从 Vibe Coding 升级为工程化开发。

核心理念：Vibe Coding（让 AI 随意写代码）很爽，但不够可靠。本模板教你用工程方法论驾驭 AI，从"会说不会做"变成"按规矩干活的高级开发者"。

1. 将本模板 clone 到你的项目目录
2. 安装依赖：pip install -r requirements.txt
3. 打开 CodeBuddy Code（或其他支持 CODEBUDDY.md 的 AI 编程工具）
4. 输入 /lesson 开始课程

本课程以项目驱动的方式组织，每个模块围绕一个真实项目，在做的过程中自然学习对应技能：

第 0 课：导论 — 什么是 Vibe Coding？
    │
    ▼
模块一：URL 短链接生成器 ── 学会 brainstorming + TDD + verification
    │
    ▼
模块二：Bug Hunt ──────── 学会 systematic-debugging + code-review + git-workflow
    │
    ▼
模块三：依赖健康检查器 ── 全技能串联 + simplicity-first + writing-skills + learning-reflection

模块	项目	学习的技能	难度
导论	-	Vibe Coding 概念与课程路线图	-
模块一	URL 短链接生成器	brainstorming, tdd, verification	入门→中级
模块二	Bug Hunt（修 7 个 Bug）	systematic-debugging, code-review, git-workflow	中级
模块三	依赖健康检查器	writing-plans, simplicity-first, writing-skills, learning-reflection + 前两模块全部技能	中高级

技能	一句话	所在模块
brainstorming（需求澄清）	动手之前先想清楚	模块一
tdd（测试驱动开发）	没有失败的测试，不写代码	模块一
verification（完成验证）	"应该没问题"不算验证	模块一
systematic-debugging（系统化调试）	不猜测，找根因	模块二
code-review（代码审查）	提交前必须过审查	模块二
git-workflow（Git 工作流）	有意义的提交和分支	模块二
writing-plans（任务规划）	大任务拆成 2-5 分钟小步	模块三
simplicity-first（简洁优先）	YAGNI，不过度工程	模块三
writing-skills（元技能创作）	学会创建自己的技能	模块三
learning-reflection（学习反思）	做完要反思，反思才成长	模块三

命令	说明
/lesson	开始或继续课程
/lesson 2	跳转到模块二
/practice	进入练习模式
/review	对当前代码执行审查
/reflect	进行学习反思

vibe-coding-template/
├── CODEBUDDY.md                 # AI 行为配置
├── .codebuddy/
│   ├── rules/                   # 始终生效的工程规则
│   ├── skills/                  # 10 个教学技能
│   └── slash-commands/          # 4 个教学命令
├── docs/
│   ├── lessons/                 # 4 个课程文件（导论 + 3 个模块）
│   └── reflections/             # 学习反思记录
└── exercises/                   # 3 个实战练习
    ├── 01-shorturl/             # 模块一项目
    ├── 02-depcheck/             # 模块三项目
    └── 03-bug-hunt/             # 模块二项目

本模板的软件工程技能改编自 Superpowers 框架（MIT License），针对教学场景做了精简和增强。

• 仓库地址：cnb.cool/sashavagals/SuperpowerDoc
• Superpowers 原版：github.com/obra/superpowers
• Superpowers 中文增强版：github.com/jnMetaCode/superpowers-zh