vibe-coding-kit

不教你写代码，教你把"用 AI 写代码"这件事，彻底想明白。

A planning toolkit for vibe coders who don't (yet) write code.

---

需求没说清，等于没说。 AI 不会卡住——它会朝着错误的方向，飞速地、自信地，把你的项目实现出来。

如今谁都能把一个想法甩给 AI，几分钟跑出个能动的东西。但真正把它做成、做对、不半路崩掉的人，少得多。差距从来不在"会不会调 AI"，而在两件事：开工前有没有把需求想清楚，开工后有没有守住纪律。

这套工具，就是把这两件事，拆成任何人都能照着做的步骤。

---

它解决什么

你大概经历过其中至少一种：

• 想法很清楚，AI 写出来的却完全不是那回事，来回扯皮一下午。
• demo 跑通了，越改越乱，最后连之前能用的版本都找不回来了。
• AI 信誓旦旦说"已完成"，你一跑，根本不行。
• 面对它给的几个技术方案，你一个字都看不懂，只能闭眼选一个。

这些都不是技术问题，是方法问题。而方法，是可以学的。

30 秒看懂它的价值

同一个人，同一个想法，区别只在于"怎么说"：

第二种，AI 能直接开干，而且不会跑偏。本套件做的，就是带你从第一种，走到第二种——并且一路护送到上线。

套件里有什么

六个轻量 Skill，在你需要的那一刻，自动登场：

Skill	什么时候用	给你什么
💬 prd	"帮我理需求" / "帮我写个 PRD" / 想清楚再开工	访谈式 Agent：一问一答 + 岔路口给建议，产出 PRD 文件
🎯 requirements	"我想做个 X" / 跑 demo / 对齐需求	该不该写代码的自检 + 需求四要素 + 把需求补全
🧭 architecture	选技术栈 / 看不懂 AI 给的方案	看懂任何架构的 6 个维度 + 选型五步法
🚀 production	demo 想做成正式系统 / 部署上线	开发规范 + 安全基线 + 部署 + 验收 + 文档
🛟 survival	"AI 越改越乱" / 改坏退不回去 / AI 忘事	贯穿全程四件事 + 红线 + 项目说明书
✅ harness	产出物写完后 / "帮我质检" / "检查合不合规"	质检 Agent：逐条校验产出格式、章节完整性、跨 Skill 一致性

不知道从何说起？ 在 Claude Code / Codex 里直接用 prd 这个访谈 Agent——它会像产品顾问一样一点点问你，在你判断不了的地方（尤其"这东西该活在哪""用什么技术"）给你选项和推荐，最后把 prd.md 写进你的项目目录。

🧬 Harness 治理层（新增）

除了六个 Skill，这套件现在自带一套三层治理体系，确保 AI 的每次产出格式统一、质量达标：

层	文件	作用
Layer 1 · 宪法	CLAUDE.md	AI 对话开始时自动加载的最高规则：语言、命名、必须章节、禁止事项
Layer 2 · 质检	skills/vibe-coding-harness/	事后逐条校验产出物，报告违规 + 给出修复建议
Layer 3 · 硬约束	每个 SKILL.md 末尾	Skill 自己的交付前自检清单，不通过就不算做完

三层从 harness.json（根目录的结构化配置文件）统一派生，改一处，三处同步。Claude Code 用户开箱即用；ChatGPT/Codex 用户把 CLAUDE.md 贴到 system prompt 即可。

流程治理（v2 新增）： 除了"管产出物"，Harness 现在还"管过程"——harness.json 的 workflow 块把流程定义成 S1 需求 → S2 选型 → S3 上线 的有序流水线，每阶段有出口门、每步有退出条件。一个 docs/进度账本.md 记录"当前走到第几步"，AI 每轮先读、每过一步回写，没过门不准往下冲，跳步要留痕。这解决了"纯 Skill 在对话里不按步骤推进、乱序跳步"的问题。详见 docs/Harness-v2-重设计方案.md。

项目进度卡（v2.1 新增）： docs/进度账本.md 管 S1/S2/S3 流程门，.dsu/progress/ 管开发期上下文恢复。默认只读 .dsu/progress/index.md，任务涉及某个模块时再读 .dsu/progress/modules/duXX-xxx.md，需要复盘单次任务时才读 .dsu/progress/tasks/任务ID.md。总表只放索引级信息：当前阶段、当前主线、完成 DU、进行中 DU、下一步、最大风险。模板见 examples/项目进度卡-总表模板.md、examples/项目进度卡-模块模板.md、examples/项目进度卡-任务模板.md。

📚 方法论库（references/方法论）

Skill 不再把产品方法论抄在每个文件里，而是统一收进 references/方法论/——问题优先、RICE/MoSCoW 优先级、EARS 验收格式、边界清单、非功能模板、HEART 指标、用户研究全流程等。Skill 在你卡住时指向对应那份，你不需要通读。脾气照旧：方法论是工具箱不是检查表，demo 阶段一律打折，挑真用得上的几件。

新增的两个行为：① 分诊——开问之前先判断需求"分量"，简单需求轻问快走，复杂需求才深问（"能自己推断的别问用户"）；② 推荐选项 clarify——不再用开放式问题轰炸小白，而是先陈述理解、把默认假设做成 [✓ 就这样] [换一个：…] 的推荐项让你一眼确认。既不让你面对空白，也不替你闷头做主。

你的旅程

不止于"做完"——把小白带成行家

大多数工具教你"怎么用 AI 把事办成"。这套件多走一步：让你逐步看懂自己在做什么。

architecture 里的「6 个维度」和「把 AI 当老师」，不是让你照搬话术，而是让你学会拷问任何方案——数据存哪、谁在跑、依赖几何、值不值这个复杂度。用上几个项目，你会发现自己不再需要话术,因为你已经能一眼看穿方案的好坏。

这才是它和"又一个 prompt 合集"的根本区别。

快速开始

每个 Skill 就是一个含 SKILL.md 的文件夹——这是通用的 Skill 格式。下面三种用法，从最省事到最进阶，挑一个适合你的：

方式一 · 零安装，复制即用（最简单，人人都会）★ 推荐先用这个

不想折腾任何设置，30 秒就能试：

1. 打开本仓库，进 skills/ 里你想用的那个文件夹（不知道选哪个？先用 vibe-coding-requirements）。
2. 点开里面的 SKILL.md，全选复制全部内容。
3. 回到你和 AI 的对话框（Claude、ChatGPT、Codex 都行），粘贴进去，再补一句"请按上面这套方法帮我"。

就这样，立刻能用。先把它跑顺，确认有用了，再考虑下面更省心的方式。

方式二 · Claude 网页/桌面版：上传成自定义 Skill

如果你常用 claude.ai 网页版或桌面 App（需要 Pro 及以上套餐）：