开源仓库:ai-phased-development-protocol —— Phase-Gate 状态机驱动的 AI 编程 Skill,强制分阶段推进。
问题
AI 结对开发最常见的失败模式不是「写错代码」,而是一口气写太多:需求还没对齐就产出上千行,返工成本高到不如重来。模型的能力越强,这个坑越深——它总能写出「看起来完整」的东西。
协议
把开发过程编码成一台状态机,每个阶段有明确的入口条件、产出物和退出门(gate),不通过验收就不允许进入下一阶段:
- Phase 0 · 对齐:只许输出需求理解和边界清单,禁止写代码;
- Phase 1 · 骨架:只搭目录、接口签名、空实现,产出物是「能编译的空壳」;
- Phase 2 · 竖切:选一条最薄的端到端路径打通,产出物是「一个能跑的用例」;
- Phase 3 · 横铺:按竖切验证过的模式批量铺开其余功能;
- Phase 4 · 加固:测试、边界、安全审计,产出物是可交付版本。
关键设计:gate 是硬约束而非建议。协议以 Skill 形式安装进 AI 工具链,模型在 gate 未通过时会拒绝继续——把「自律」外包给了状态机。
实证
- StudySolo(431 次提交,获奖):Phase 2 竖切选了「单节点工作流从生成到执行」,后续 18 种节点全部按同一模式横铺;
- MedShow(113k 行):22 次数据库迁移与分阶推进一一对应,没有一次「推倒重来」;
- HBPattern:Phase 0/1 的产出物直接沉淀为 67 篇文档,文档代码比 2.4:1。
边界
协议对探索型任务失效:当你不知道要做什么时,状态机只会把你锁在 Phase 0。这时应该退回「一次性原型 → 扔掉 → 再立项」的循环,原型不受协议约束。