描述
Spec-first Agentic Development引入了一种与AI编码代理合作的结构化方法，确保每个变更都由明确的、经过审查的规范启动。这种方法旨在通过在整个开发生命周期中整合人类监督和自动检查，增强AI代理开发代码的可靠性和可维护性。
阅读更多
核心原则是每个开发任务都以存储在代码库中的书面规范开始。该规范概述了目标、相关事实（包括文件和行引用）、要采取的步骤以及精确的“完成”标准。在编写任何代码之前，一位新的审查者会检查规范与现有代码库的准确性和可行性。一旦获得批准，AI代理便在其自己的隔离分支和工作树上构建该功能。最终提交仅在所有预定义的检查和测试通过后才能进入主代码库，从而确保代码质量和遵循规范。
该系统与传统的“随意编码”显著不同，通过用经过审查的、持久的规范替代临时提示。它记录代理做出的每个决策及其推理，提供清晰的审计轨迹，减少了后期开发文档的需求。规范旨在明确意图和架构，而不是过于精确的代码生成器，测试和提交门提供必要的精度。旧规范被视为不可变的变更记录，类似于提交，不会更新，从而防止过时。
Spec-first Agentic Development支持并行开发，允许多个代理同时在不同的规范上工作，使用独特的分支和工作树ID。该过程不受干扰，因为经过审查的规范预先回答了开放问题，使代理能够直接构建到完成标准。整个工作流程是结构化的，一个规范对应一个分支和一个提交，简化了拉取请求并确保一致性。状态保存在`context.yaml`中，使工作即使在重启后也能恢复。
该方法、模板和Claude Code插件均为MIT许可，成为一种无成本的解决方案。虽然Claude Code插件自动化了记账和门控功能，但该方法也可以与Codex、Cursor或Copilot等其他代理一起采用，只需遵循`AGENTS.md`并安装git commit-msg钩子以进行门控。该方法通过创建Agent Smith，一个开源的代理软件工厂，得到了开发和完善，展示了其实际应用和有效性。
- 类别AI 编程助手
- 定价模式免费
- 部署云端
- 平台网页版
Spec-first Agentic Development的核心功能
以规范驱动的AI编码代理开发
在构建之前检查与代码的审查规范
每个开发任务的隔离工作树
要求所有检查通过的门控提交
存储在代码库中的持久规范
带有推理的决策日志以便追溯
支持使用唯一分支ID的并行开发
状态存储在context.yaml中以实现可恢复的工作流程
MIT许可的方法、模板和Claude Code插件
与Codex、Cursor、Copilot和终端的兼容性
用于强制提交门的Git commit-msg钩子
自动化证据检查以验证规范引用
针对单个或系列规范的结构化拉取请求
从现有代码库生成的上下文和规则
Agent Smith的构建过程无需手写代码
如何使用 Spec-first Agentic Development？
安装插件/钩子：在您的项目克隆中安装Claude Code插件或git commit-msg钩子。
引导项目：运行/spec-first:bootstrap-project以从现有代码生成上下文和规则。
创建规范：使用create-spec技能定义一个新任务，包括目标、步骤、事实和完成标准。
审查规范：让一位新的审查者检查规范与代码的准确性和可行性。
应用规范：代理在自己的分支和工作树上构建规范，遵循项目规则。
交付规范：通过门控提交更改，确保所有检查通过，并打开拉取请求。
交付系列：对于较大的变更，使用/spec-first:deliver-series来管理和交付多个相互依赖的规范。
Spec-first Agentic Development的使用案例
- AI代理代码开发
- 确保代码质量
- 管理复杂项目
- 增强代码可追溯性
- 促进代码审查
- 自动化开发工作流程
- 帮助新开发者入门
- 与现有工具集成
