Spec-Driven Develop Skill：让 AI 编程代理按架构规格做事的大型项目工作流

Skill超级捕获手 技术创作者 2026-08-09 1303 阅读

让 AI 编程代理真正「按规矩办事」：Spec-Driven Develop 以架构为先、规格驱动的工程化工作流，正在成为大型代码改造项目的标配 Skill。

Spec-Driven Develop 是一个面向 AI 编程代理的规格驱动开发工作流。它将钱学森工程控制论思想引入 AI 编码场景，用纯 Markdown 技能包驱动 Claude Code、Codex、Cursor 等主流代理完成大型复杂任务——从项目深度分析、任务拆解、GitHub Issue/PR 追踪到自适应反馈闭环，全程规格先行、文档驱动，而非让 AI 自由发挥。项目 Star 增长迅猛，GitHub Trending 持续在榜，已成为 AI 工程化开发领域的标杆级 Skill。

功能与原则

Spec-Driven Develop 包含三个互补的 Markdown Skill：

  • Spec-Driven Develop：大型复杂任务的全流程自动化开发管线，覆盖七阶段流水线（Phase 0–6），从架构分析到任务分解、进度追踪、批量 PR 交付。
  • Deep Discuss：结构化深度讨论工作流，通过多阶段自律思维进行问题分析、脑暴和方案设计。
  • Review SPD：以发现为核心的代码审查工作流，专注于未提交变更、日期范围提交和分支/PR 差异中的缺陷与回归。

核心设计原则：规格驱动（Spec-First）、架构先行（Architecture-First）、orchestrator 主导（主代理负责进度与质量，子代理调度是经济决策而非默认）、无 SDK 依赖（纯 Markdown + 可选小脚本）。

认可度

  • GitHub Star：截至 2026-08-09，约 961 ⭐（97 forks）
  • GitHub Topics：20 个标签，含 ai-agent、claude-code、spec-driven-development、engineering-cybernetics 等
  • 最新推送：2026-07-26，仍在活跃维护
  • 平台覆盖：Claude Code、Codex、OpenCode、Cursor、Windsurf、Cline、Aider、Continue、Roo Code、Augment 等

链接

GitHub：https://github.com/zhu1090093659/spec_driven_develop

原作者

GitHub 用户 @zhu1090093659，项目采用 MIT 许可证，开源社区驱动维护。

介绍

传统开发中，规格文档往往被当作一次性临时脚手架——写完就丢，实际编码时很少回看。但对 AI 编程代理而言，规格是唯一可靠的「记忆锚点」。Spec-Driven Develop 将规格驱动开发（Spec-Driven Development）理念移植到 AI 编码场景，让 AI 代理在动手之前先理解架构、分解任务、建立追踪机制。

当你在对话中告诉 AI「把这个项目用 Rust 重写」或「迁移到微服务架构」时，Spec-Driven Develop 立即启动七阶段流水线：快速意图捕获（Phase 0）→ 深度架构分析含 S.U.P.E.R 健康评估（Phase 1）→ 意图澄清与约束确认（Phase 2）→ 任务拆解与 GitHub Issue 创建（Phase 3）→ MASTER.md 进度索引生成（Phase 4）→ 计划确认与分批执行（Phase 5）→ 归档留存（Phase 6）。整个过程有规格文档兜底，AI 不会跑偏。

项目另一大亮点是自适应反馈控制——借鉴工程控制论思想，在执行过程中观察现实偏差（drift score），当计划与实际执行出现漂移时自动纠偏，保证交付质量而非一味赶进度。

特点

  • 三 Skill 合一：Spec-Driven Develop / Deep Discuss / Review SPD，覆盖开发全周期
  • 零依赖：纯 Markdown 技能包 + 可选小 Shell 脚本，无需 SDK 或第三方运行时
  • GitHub 原生集成：自动创建 Issue、Milestone、Label、Project Board，支持 worktree 隔离分支与批量 PR
  • 三模式自动降级：检测环境后自动切换 GITHUB_FULL → GITHUB_STANDARD → LOCAL_ONLY，无 gh CLI 时也能正常运行纯 Markdown 版
  • orchestrator 主导的执行策略：主代理负责质量，子代理只在值得时才调度（Tier 1 处理大批次，Tier 2 才并行lanes）
  • 多 AI 平台兼容：覆盖主流 AI 编程代理生态，不锁定特定厂商

使用方法

安装（Claude Code 为例）：

在 Claude Code 项目中克隆仓库，并将技能链接到共享目录：

git clone https://github.com/zhu1090093659/spec_driven_develop.git
cd spec_driven_develop
# 方式一：将所有技能同步到 ~/.agents/skills（推荐）
./scripts/install-agents.sh

# 方式二：在项目内引用
# 将 plugins/spec-driven-develop/ 目录内容放入项目 .claude/skills/ 下

基本调用：

当需要处理大型改造任务时，直接在对话中描述需求，Skill 会自动激活七阶段流水线：

# 示例：迁移项目到微服务架构
> 将这个单体应用拆分为微服务架构

# Spec-Driven Develop 会自动启动：
# Phase 0: 捕获高层意图
# Phase 1: 深度架构分析 + S.U.P.E.R 评估
# Phase 2: 澄清问题确认范围
# Phase 3: 拆解任务 + 创建 GitHub Issue
# Phase 4: 生成 MASTER.md 进度索引
# Phase 5: 分批执行 + 代码审查
# Phase 6: 归档

Deep Discuss 独立调用：

> 用 Deep Discuss 分析我们是否应该引入 WebAssembly

Review SPD 独立调用：

> 用 review-spd 审查从 v2.1 到现在的所有提交

使用场景与人群

适用场景：

  • 大型代码改造（语言迁移、架构重构、微服务拆分）
  • 多阶段复杂功能实现（需要分批交付和进度追踪）
  • 团队协作的 AI 辅助开发（需要 GitHub Issue / PR 规范化管理）
  • 需要结构化深度讨论的技术决策（技术选型、架构演进方向）

目标用户：

  • 使用 Claude Code / Codex / Cursor 等 AI 编程代理的开发者
  • 需要 AI 代理完成大型、长期、多阶段项目的工程团队
  • 关注 AI 工程化实践、追求「AI 做事有规矩」的高级用户

输入与输出案例

案例一：大型重构任务

  • 输入：将这个 Django 项目迁移到 FastAPI + 异步架构
  • 输出：Phase 1 输出完整的架构分析报告（含模块依赖图、S.U.P.E.R 健康评分）；Phase 3 自动创建 12 个 GitHub Issue（按 Phase 分组 Milestone，带 priority/size 标签）；Phase 5 交付一个含 12 个 Issue 关闭记录的批量 PR

案例二：结构化深度讨论

  • 输入：用 Deep Discuss 分析是否引入 WebAssembly
  • 输出：多阶段结构化分析——问题定义 → 多角度分析 → 方案对比 → 风险评估 → 推荐结论，每阶段有明确产出文档，AI 不跳步、不遗漏

Star 数据来源：GitHub API，截至 2026-08-09

GitHub: https://github.com/zhu1090093659/spec_driven_develop

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1303 阅读