Specification First 插件将 AI 编码流程从提示词驱动转为规格驱动并强制前置审查

该工具提出 Specification First 方法，要求所有 AI 编码变更必须先以 YAML 格式编写包含文件行号事实、目标与完成标准的规格书，并在构建前由无上下文的新审查者（或 Agent）进行验证。其核心机制是通过 git hook 和 commit gate 阻断未通过验证的提交，确保只有符合规格且测试通过的代码才能进入仓库，从而在工程层面消除“vibe coding”带来的不确定性。

该方法在 Agent Smith 项目中已验证，累计处理超过 1,300 个规格，生成了 1,190+ 个决策文件。每个决策文件记录了具体选择（如使用 Raw HttpClient 而非 Octokit）、被否决的方案及其原因，这些逻辑与代码同库存储，形成可追溯的推理链。系统支持并行工作树，根据依赖关系分组构建，并将状态保存在 context.yaml 中以实现中断恢复，同时通过 AGENTS.md 让不同 Agent 框架遵循同一套文件规范。

事实层面，该插件目前作为 MIT 许可的开源项目发布，主要集成于 Claude Code，但设计为通用标准，允许其他 Agent 通过读取相同文件结构配合 git hook 运行。推断上，这种模式试图将 AI 编码从概率性生成转变为确定性工程流程，通过增加前置审查成本来换取交付质量的可控性。猜测的是，这种强约束流程是否会降低开发效率，取决于团队对“规格编写时间”与“后期调试修复时间”的权衡，以及现有 CI/CD 管道对该格式的适配程度。