zhu1090093659/spec_driven_develop

解决的问题

Spec-Driven Develop 为 AI 编码代理提供了一种结构化、以架构为先的流程，用于处理大规模软件变更——如迁移、重写和复杂重构——而不会丢失进度或盲目执行有缺陷的计划。它防止了 AI 代理在复杂实现过程中偏离原始意图或引入架构退化这一常见问题。

如何工作

该项目是一组与平台无关的基于 Markdown 的「技能」，AI 代理可以读取并执行。它实现了七阶段流程（从意图捕获和深度分析到执行和归档），并使用一种称为「自适应控制」的闭环反馈系统来监控执行遥测数据。如果代理的进展偏离计划过多，系统将自动触发路线修正或任务重新分解。

它原生集成 GitHub，通过 Issues、Milestones 和 Labels 跟踪任务，将工作分组为连贯的「交付批次」，而非零散的 PR。它还包含两个辅助工作流：「Deep Discuss」用于结构化技术头脑风暴，以及「Review SPD」用于以发现为先的代码审查，重点关注缺陷和回归问题。

适用人群

使用 AI 编码代理（如 Claude Code、Cursor、Windsurf 或 Aider）进行高风险、大规模架构变更或需要严格规划与追踪的复杂功能实现的开发者。

主要亮点

• S.U.P.E.R 架构原则：通过自动化健康检查和检查清单，强制执行单一职责、单向流、端口优于实现、环境无关、可替换部件。
• 自适应控制循环：受控制论启发的反馈系统，当执行偏差超过特定阈值（20%、40%、60%）时，会暂停或重构计划。
• 原生 GitHub 追踪：自动创建 Issues 和 Milestones，管理工作树和批量 PR，实现专业级项目管理。
• 平台无关：可作为 Claude Code、Codex 和 OpenCode 的插件使用，也可作为任何支持自定义指令的代理的简单 Markdown 技能。