AI编程规范

【AI Coding】AI 编程工作流对比

【AI Coding】AI 编程工作流对比：Spec-Kit、OpenSpec、Superpowers

来源：[[AI 编程工作流选型：Spec-Kit、OpenSpec、Superpowers 深度对比]]

用 AI 编程代理写代码时的核心矛盾：AI 代理缺乏结构化的工作流约束。

表现为：

代理写出的代码风格飘忽不定，每次都要重新解释项目规范
多人协作时代理理解不一致，同样的需求给出完全不同的实现
想让代理遵循测试驱动开发，但它总爱跳过测试直接写代码

三者概览

维度	[[Spec-Kit]]	[[OpenSpec]]	[[Superpowers]]
出品方	GitHub 官方	Fission-AI	Jesse Vincent (obra)
核心范式	规范可执行化	轻量规范层	技能组合
Star 数	82.5K	34.5K	115K
主要语言	Python	TypeScript	Shell/JavaScript
安装方式	`uv tool install`	`npm install -g`	插件市场/手动配置
AI 代理支持	11+	20+	5+
是否需要 API Key	取决于代理	❌ 不需要	取决于代理
是否需要 MCP	取决于代理	❌ 不需要	取决于代理
TDD 强制	❌ 不强制	❌ 不强制	✅ 强制
Brownfield 支持	✅ 支持	✅ 优先设计	✅ 支持
学习曲线	中等	平缓	平缓

工作流范式对比

Spec-Kit：阶段门控式

constitution → specify → clarify → plan → tasks → analyze → implement
     ↓            ↓         ↓        ↓       ↓        ↓         ↓
   [门控]      [门控]    [门控]   [门控]  [门控]   [门控]    [门控]

哲学：结构胜过混乱
特点：每个阶段都是一道"门"，必须完成当前阶段才能进入下一阶段
适用：大型项目、多人协作、质量可控、流程可追溯

OpenSpec：流畅迭代式

/opsx:propose → /opsx:apply → /opsx:archive
      ↓              ↓             ↓
   [提案]         [执行]        [归档]

哲学：迭代胜过瀑布
特点：没有严格的阶段门，可以随时调整提案，变更驱动
适用：快速迭代、频繁调整、灵活性高、学习曲线低

Superpowers：技能触发式

brainstorming → writing-plans → executing-plans → TDD → code-review
      ↓              ↓               ↓            ↓        ↓
   [自动触发]     [自动触发]       [自动触发]   [自动触发] [自动触发]

哲学：流程胜过猜测
特点：通过上下文自动触发相关技能，不是手动调用命令
适用：质量优先、强制 TDD、自动强制质量门

技术选型决策

场景	推荐	原因
大型企业项目	[[Spec-Kit]]	GitHub 官方维护、阶段门控确保质量、企业级团队功能成熟
快速迭代/个人项目	[[OpenSpec]]	轻量级、学习曲线平缓、支持 20+ 工具、无需配置 API Key 和 MCP
质量优先/强制 TDD	[[Superpowers]]	强制 TDD、自动技能触发、子代理并发执行、社区规模最大
现有代码库改造 (Brownfield)	[[OpenSpec]]	明确打出"built for brownfield"旗号、变更驱动、渐进式改造
跨工具开发	[[OpenSpec]]	支持 20+ AI 编程工具、切换工具无需重新配置、规范是通用格式
需要规范生成代码	[[Spec-Kit]]	规范可执行化是核心定位、模板引擎支持代码生成

三者的局限

Spec-Kit 的局限

相对重量级：需要 Python 3.11+ 和 uv，环境配置有一定门槛
阶段门较严格：不适合需要频繁调整方向的项目
学习曲线较陡：七个阶段需要时间理解

OpenSpec 的局限

规范不直接生成代码：只能指导，不能执行
企业功能开发中：团队协作功能尚不完善
社区规模较小：34.5K Star，生态相对薄弱

Superpowers 的局限

非规范驱动：没有独立规范层，规范是副产品
依赖代理平台：安装方式因平台而异
缺少正式文档站点：主要靠 GitHub README 和社区

总结

三个工具的核心差异：

[[Spec-Kit]]：规范 可执行，生成代码
[[OpenSpec]]：规范 轻量化，灵活迭代
[[Superpowers]]：技能 自动触发，强制质量

💡 最后提醒：工具是手段不是目的。如果项目规模小、团队人数少，简单的 Git 提交规范 + Code Review 可能就够了——别为了用工具而用工具。

核心洞察：

三种工具代表三种不同的哲学：

Spec-Kit：结构胜过混乱（阶段门控）
OpenSpec：迭代胜过瀑布（流畅迭代）
Superpowers：流程胜过猜测（技能触发）

有趣的是，Hermes Agent 的技能系统（test-driven-development、systematic-debugging 等）与 Superpowers 的理念非常接近——都是通过预定义的技能来约束 AI 行为，确保质量。

你目前用哪种工作流？还是说现在还是"裸奔"状态，全靠 prompt 临时发挥？😄