Documentation
README
开发避坑与自救:贯穿全程的纪律
这是 vibe-coding-kit 里贯穿整个开发过程的 Skill。前面几个 Skill 是"开工前想清楚",但 Vibe Coding 真正翻车,大多发生在"开工后"。下面这些不属于某个阶段,要在整个开发过程里持续做。对不写代码的人来说,这几件事比任何技术选型都重要。
配套:
vibe-coding-requirements(需求)、vibe-coding-architecture(选型)、vibe-coding-production(上线)。
流程角色: 本 skill 是
harness.json里的always_on——不占流水线某一阶段,而是全程在跑。它和账本(docs/进度账本.md)的关系有两条:① 卡住、改坏、改不动时,把问题记进账本的「阻塞项」;② 红线(动钱 / 动别人隐私)是硬提示,一旦触及,不管在哪个阶段都要停下来提醒用户找真人把关——这条优先级高于"按门推进"。
一、贯穿全程的四件事
1. 管理好和 AI 的对话(最易忽略,却最致命)
AI 在长对话里会"忘事"——聊久了它会忘记早先的决定、自相矛盾,甚至改坏之前好的部分。对策:
- 维护一份项目说明书(见第三节),每开一个新对话,先把它整段贴进去。
- 一个功能做完、对话变得又长又乱时,果断开新对话,别恋战。
- 重要决定(选了什么技术、定了什么规则)随手记进说明书,别只存在对话里——对话会丢、会乱、会被你关掉。
This is the opening of the README. Read the full README on GitHub.