vibe-coding-survival

npx skills add Junliu1066/vibe-coding-kit --skill vibe-coding-survival --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 开发避坑与自救：贯穿全程的纪律 这是 **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 在长对话里会"忘事"——聊久了它会忘记早先的决定、自相矛盾，甚至改坏之前好的部分。对策： - 维护一份**项目说明书**（见第三节），每开一个新对话，先把它整段贴进去。 - 一个功能做完、对话变得又长又乱时，**果断开新对话**，别恋战。 - 重要决定（选了什么技术、定了什么规则）随手记进说明书，别只存在对话里——对话会丢、会乱、会被你关掉。 ### 2. 守住范围（别让 demo 越长越大） 做着做着冒出"要不再加个……"，AI 每次都说行，于是越加越多、越来越脆，最后全盘崩掉。对策： - 准备一个"**以后再说**"清单。新点子先记进去，**不打断**当前这件事。 - 当前这件事彻底做好、能用了，再回头看清单，挑真正值得的做。一次只推进一件事。 ### 3. 保住能用的版本（别把唯一能跑的版本改坏） 非技术用户最痛的事：改着改着坏了，又退不回去，之前能用的也没了。对策： - 每当一个版本"**能正常用**"，就完整复制一份存好（比如把整个文件夹复制成 `项目-2024-06-能用版`）。 - 之后再大胆改也不怕，坏了就从备份拿回来。 - 懂 git 的话用 git 更专业；但对不写代码的人，"**复制整个文件夹**"是最朴素可靠的保险，别嫌土。 ### 4. 让 AI 证明给你看（别轻信"我做好了"） AI 经常很自信地说"已完成"，但实际没跑通——它不是骗你，是它自己也没真运行过。对策： - 每次它说做好了，就追问："**我怎么自己验证它真的好了？给我具体步骤。**" - 然后你**亲手**按步骤跑一遍。没亲眼看到它在你这儿跑通，就别当它做完了。 ---