开源我的 Vibe Coding 工作流，已有人靠它把项目做完了
前言
如果这篇文章对你有帮助，欢迎先去给仓库点个 Star：project-vibe-spec，这对我是很大的鼓励，也让更多人能找到这个工具。
大家好，我是汉堡。
上一篇文章《如何从0到1 Vibe Coding 一个项目，并长期维护》里，我分享了自己踩坑之后沉淀出来的一套 Harness 体系——用文档治理、AGENTS.md、范围冻结和分阶段推进来驯服 Vibe Coding 的混乱。
文章发出去之后，有鱼友来问我：多个 AI Agent 接力做项目，怎么让它们互相"知道"彼此做了什么？
答案就在那篇文章里。多 Agent 之间通信和协作，唯一的方式只有文档。 在项目根目录维护好 Agent 的"说明书"——Codex/OpenCode 对应 AGENTS.md，Claude Code 对应 CLAUDE.md——Agent 启动时自动注入，啥也不用说就知道项目的一切。
有人照着做了，昨天来告诉我："牛逼，用了文章里的内容之后，AI 的产出就稳多了，现在已经把项目做完了，感谢大佬。"
这让我很开心。所以今天这篇文章，我想介绍一个更进一步的东西——我把那套方法论直接做成了一个可以复用的 Agent Skill。
为什么要做成 Skill？
上篇文章写的是思路和方法，但每次新建项目，你还是得自己手写 AGENTS.md、搭 docs/ 目录结构、想文档命名规范……
重复劳动，而且容易遗漏。
所以我把这套体系沉淀成了一个开箱即用的 GitHub 仓库：
如果这个 Skill 对你有帮助，欢迎点个 Star，这对我是很大的鼓励。
这个 Skill 解决什么问题？
回顾一下 Vibe Coding 的几个典型困境：
- 上下文膨胀：代码越多，AI 越难理解全貌
- 耦合蔓延：改一处牵一发而动全身
- 意图退化：没有文档，几轮对话后你自己都忘了当初为什么这么设计
- 多 Agent 失忆：换一个 Agent 工具，之前的上下文全部归零
这些问题都可以追溯到同一个原因——缺乏工程化的文档治理。
project-vibe-spec 提供了一套完整的项目规范模板，让你在开始写第一行代码之前，就把"地基"打好。
Skill 里有什么？
1. AGENTS.md 模板
这是整个体系的核心。AGENTS.md 干的事情只有一件：让 AI 知道你的编码哲学和项目规范，不用每次都重复交代。
对于 Codex/OpenCode，启动时会自动将项目级别和全局的 AGENTS.md 注入当前对话上下文。你啥也不用说，Agent 就知道：
- 项目的技术栈和架构
- 代码风格和命名规范
- 禁止的行为（比如不要擅自改架构、不要顺手加功能）
- 文档优先级和冲突解决规则
- 完成标准（DoD）
2. 文档治理体系
一套完整的文档分类规范：
| 文档类型 | 命名格式 | 用途 |
|---|---|---|
| REQ 需求文档 | REQ-YYYYMMDD-XX-*.md | 新功能或大范围改造前必写 |
| PROG 进度日志 | PROG-YYYYMMDD.md | 每天一日志，记录完成了什么 |
| BUG 缺陷记录 | BUG-YYYYMMDD-XX-*.md | 发现 bug 立即记录 |
| BIZ 业务决策 | BIZ-YYYYMMDD-XX-*.md | 业务流程或实现策略的确认 |
| DEV 技术方案 | DEV-YYYYMMDD-XX-*.md | 复杂模块拆解、阶段实施方案 |
这套体系的价值：
- 上下文外挂：AI 每次对话前先读相关文档，不会丢失上下文
- 可追溯：三个月后回来，还能知道当初为什么这么设计
- 可交接：换一个 AI 模型或工具，读一遍文档就能接手
3. 分阶段推进模板（Phase 0 → Phase N）
大项目一口气让 AI 实现 = 灾难。必须拆阶段，每个阶段有明确的 DoD（Definition of Done）：
| 阶段 | 内容 | DoD |
|---|---|---|
| Phase 0 | 文档体系初始化 | AGENTS.md、README.md、docs/ 结构就绪 |
| Phase 1 | 后端骨架 | 服务可启动、配置可读、数据库可初始化 |
| Phase 2~3 | 核心链路 | 端到端链路跑通 |
| Phase 4 | 业务 API | 接口字段对齐、错误响应统一 |
| Phase 5 | 前端工程化 | 拆页拆组件、接入真实 API |
| Phase 6~7 | 收尾上线 | 链路闭环、打包部署 |
每个 Phase 结束必须达到 DoD 才能进入下一阶段。这个纪律不能破。
4. 范围冻结清单
v1 要做什么、不做什么，在一开始就写死。一旦范围冻结，后续开发中 AI 想"顺手"加功能时，你就可以说："不在 v1 范围，先记 REQ，下个版本再说。"
怎么用？
直接 clone 或 fork 这个仓库，把模板文件复制到你的项目根目录，按照说明填写你的项目信息即可。
▼bash复制代码git clone https://github.com/dnwwdwd/project-vibe-spec
然后把 AGENTS.md、docs/ 目录结构复制到你的项目里，根据你的项目实际情况填写内容。
真实反馈
这套方法论有人真的用了。
有读者看了上篇文章之后，把这套文档治理的思路用到了自己的项目上。几天后来反馈：AI 的产出稳定了很多，项目已经做完了。
我写这篇文章、做这个 Skill，就是想把这套工程化方法变成别人可以直接用的东西，不用每个人再从头踩一遍。
最后
Vibe Coding 的问题不在 AI 的能力，在我们给 AI 的上下文质量。
一个没有文档、没有规范、没有阶段划分的项目，再强的模型也推不动。换上完整的 Harness 体系——文档治理、阶段划分、范围冻结——用中等模型也能稳定推进。
project-vibe-spec 就是帮你把这个"地基"快速搭起来的工具。
仓库地址：https://github.com/dnwwdwd/project-vibe-spec
如果觉得有用，可以点个 Star，或者在评论区聊聊你的使用体验。
