AI 编程三剑客：Spec-Kit、OpenSpec、Superpowers 深度对比与实战指南

AI 编程三剑客：Spec Kit、OpenSpec、Superpowers 深度对比与实战指南 AI 编程三剑客：Spec Kit、OpenSpec、Superpowers 深度对比与实战指南 Modified April 22 Code block Plain Text Copy │ │ │ ┌─────────────────────────────────────────────────────────────────┐ │ │ │ 规范管理层 │ │ │ │ │ │ │ │ /opsx:new ───────────────── spec.md (创建规范提案) │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ /opsx:continue ──────────── spec.md (迭代细化) │ │ │ │ │ ▲ │ │ │ │ │ │ (可多次循环) │ │ │ │ ▼ │ │ │ │ │ /opsx:apply ───────┴─────── 应用到代码 │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ /opsx:archive ───────────── archived/xxx.md (归档) │ │ │ │ │ │ │ └──────────────────────────────┬──────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────┐ │ │ │ 执行方法层 │ │ │ │ │ │ │ │ /opsx:apply ───────── Superpowers TDD Loop │ │ │ │ │ │ │ │ │ ├── brainstorm（探索阶段） │ │ │ │ ├── write tests（先写测试） │ │ │ │ ├── implement（最小实现） │ │ │ │ ├── run tests（验证通过） │ │ │ │ └── code review（代码审查） │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────┘ 方案对比 ： 5.2 实战工作流 假设我们要为一个电商项目添加"优惠券系统"。下面分别演示两种方案的完整工作流。 🅰️ 方案 A：Spec Kit + Superpowers（新项目/复杂系统） 适用场景 ：从零开始的电商项目，需要完整设计文档和严格流程控制。 Step 1：建立项目宪法 Code block Plain Text Copy 创建项目治理原则（只需执行一次，全项目共享） /specify:constitution AI 会引导你定义： 代码质量标准 测试覆盖要求 安全约束 性能要求 生成的 .specify/memory/constitution.md ： Code block Plain Text Copy Project Constitution Code Quality TypeScript strict mode required No types allowed 80% test coverage minimum Security All user inputs must be validated Coupon codes case insensitive, prevent timing attacks Rate limiting on validation endpoints Performance Coupon validation < 50ms Use Redis caching for hot paths Step 2：定义功能规范 Code block Plain Text Copy 定义"做什么"和"为什么" /specify:specify Implement a coupon system with creation, validation, and application for the e commerce platform. 生成的 .specify/coupon system/specify.md ： Code block Plain Text Copy Coupon System Specification Goal Enable promotional discounts through a flexible coupon system. Requirements Create, read, update, delete coupons Validate coupon applicability Apply discount to orders Track usage statistics Constraints Must comply with constitution.md security requirements Coupons cannot be combined unless explicitly allowed Step 3：制定技术方案 Code block Plain Text Copy 定义"怎么做" /specify:plan Use PostgreSQL for storage, Redis for caching. REST API with TypeScript/Express. 生成的 .specify/coupon system/plan.md ： Code block Plain Text Copy Technical Plan Architecture CouponService: Core business logic CouponRepository: PostgreSQL persistence CouponCache: Redis caching layer CouponController: REST API endpoints Data Model coupons table: id, code, discount type, value, valid from, valid until coupon usages table: id, coupon id, order id, used at Step 4：分解任务 Code block Plain Text Copy 生成可执行任务清单 /specify:tasks 生成的 .specify/coupon system/tasks.md ： Code block Plain Text Copy Implementation Tasks Create Coupon entity and migration Implement CouponRepository Implement CouponCache with Redis Implement CouponService with validation logic Create REST API endpoints Add integration tests Add E2E tests Step 5：执行实现（+ Superpowers TDD） Code block Plain Text Copy 开始实现（自动触发 Superpowers TDD 循环） /specify:implement Superpowers 自动介入 ： 1. 探索阶段 （brainstorming） ◦ 确认技术方案细节 ◦ 识别潜在风险 2. TDD 循环 （每个任务） Code block Plain Text Copy // 先写测试 describe('CouponService', () = { it('should validate active coupon', async () = { const coupon = await createTestCoupon({ code: 'TEST20' }); const result = await couponService.validate('TEST20'); expect(result.valid).toBe(true); }); it('should reject expired coupon', async () = { const result = await couponService.validate('EXPIRED'); expect(result.valid).toBe(false); expect(result.reason).toBe('COUPON EXPIRED'); }); }); // 再写实现 // 运行测试验证 3. 代码审查 （code review） ◦ 检查是否符合 constitution.md 约束 ◦ 验证测试覆盖率 🅱️ 方案 B：OpenSpec + Superpowers（存量项目/快速迭代） 适用场景 ：已有电商项目，需要快速添加优惠券功能，不需要完整设计文档。 Step 1：创建规范提案 Code block Plain Text Copy 快速创建功能提案 /opsx:new Add coupon system with percentage and fixed discounts 生成的 spec.md ： Code block Plain Text Copy Coupon System Proposal Summary Add promotional coupon functionality to existing e commerce platform. Scope Coupon CRUD operations Validation logic Order integration Out of Scope Complex stacking rules (future iteration) A/B testing integration Step 2：迭代细化 Code block Plain Text Copy 根据反馈迭代规范 /opsx:continue Add Redis caching requirement and rate limiting 更新后的 spec.md ： Code block Plain Text Copy Coupon System Proposal Summary Add promotional coupon functionality to existing e commerce platform. Technical Decisions Use existing PostgreSQL for storage Add Redis caching for validation performance Rate limit: 10 validations/minute per user Implementation Notes Reuse existing validation middleware Follow current API conventions (REST, JSON responses) 方案对比 ： 5.2 实战工作流 假设我们要为一个电商项目添加"优惠券系统"。下面分别演示两种方案的完整工作流。 🅰️ 方案 A：Spec Kit + Superpowers（新项目/复杂系统） 适用场景 ：从零开始的电商项目，需要完整设计文档和严格流程控制。 Step 1：建立项目宪法 生成的 .specify/memory/constitution.md ： Step 2：定义功能规范 生成的 .specify/coupon system/specify.md ： Step 3：制定技术方案 生成的 .specify/coupon system/plan.md ： Step 4：分解任务 生成的 .specify/coupon system/tasks.md ： Step 5：执行实现（+ Superpowers TDD） Superpowers 自动介入 ： 1. 探索阶段 （brainstorming） ◦ 确认技术方案细节 ◦ 识别潜在风险 ◦ 确认技术方案细节 ◦ 识别潜在风险 2. TDD 循环 （每个任务） 3. 代码审查 （code review） ◦ 检查是否符合 constitution.md 约束 ◦ 验证测试覆盖率 ◦ 检查是否符合 constitution.md 约束 ◦ 验证测试覆盖率 🅱️ 方案 B：OpenSpec + Superpowers（存量项目/快速迭代） 适用场景 ：已有电商项目，需要快速添加优惠券功能，不需要完整设计文档。 Step 1：创建规范提案 生成的 spec.md ： Step 2：迭代细化 更新后的 spec.md ： 六、总结与建议 6.1 工具选择指南（决策树） 6.2 核心洞察：理解工具定位 6.3 学习路径建议 6.4 常见误区 误区 正确认识 "三个工具一起用效果最好" ❌ Spec Kit 和 OpenSpec 功能重叠，同时用会造成混乱 "规范工具会拖慢开发速度" ✅ 前期投入换来后期少返工，复杂项目 ROI 极高 "简单项目不需要规范" ⚠️ 取决于"简单"的定义，Superpowers 单独用也行 "AI 够聪明不需要约束" ❌ AI 会"Vibe Coding"，规范是防止漂移的护栏 误区 误区 正确认识 正确认识 "三个工具一起用效果最好" "三个工具一起用效果最好" ❌ Spec Kit 和 OpenSpec 功能重叠，同时用会造成混乱 ❌ Spec Kit 和 OpenSpec 功能重叠，同时用会造成混乱 "规范工具会拖慢开发速度" "规范工具会拖慢开发速度" ✅ 前期投入换来后期少返工，复杂项目 ROI 极高 ✅ 前期投入换来后期少返工，复杂项目 ROI 极高 "简单项目不需要规范" "简单项目不需要规范" ⚠️ 取决于"简单"的定义，Superpowers 单独用也行 ⚠️ 取决于"简单"的定义，Superpowers 单独用也行 "AI 够聪明不需要约束" "AI 够聪明不需要约束" ❌ AI 会"Vibe Coding"，规范是防止漂移的护栏 ❌ AI 会"Vibe Coding"，规范是防止漂移的护栏 6.5 未来展望 AI 编程工具正在从"代码补全"向"自主工程"演进。 当前阶段 ：我们需要 Spec Kit/OpenSpec 这样的规范工具来"约束" AI，防止它凭感觉乱写代码。Superpowers 这样的方法论工具确保 AI 按照工程最佳实践执行。 未来趋势 ： • 规范工具会趋同 ：Spec Kit 和 OpenSpec 解决同一问题，未来可能合并或出现更优方案 • 执行方法论会内化 ：TDD、代码审查等实践可能被 AI 原生支持 • 人机协作会深化 ：从"人写规范，AI 执行"到"人审批，AI 全程" 现在开始的意义 ： • 培养"规范驱动"的思维习惯 • 积累与 AI 高效协作的经验 • 为更自主的 AI 工程时代做准备 💡 核心理念 ：让 AI 成为可靠的工程伙伴，而非需要时刻看管的实习生。 参考资源 官方资源 • Spec Kit GitHub • OpenSpec GitHub • Superpowers GitHub • GitHub Blog: Spec Driven Development 深度对比分析 • Spec Kit vs OpenSpec 深度对比 🌟 推荐阅读，本文核心观点来源 • OpenSpec vs Spec Kit: Hashrocket 对比 入门教程 • Superpowers 入门指南 • OpenSpec OPSX 工作流文档 • OpenSpec CLI 文档 • OpenSpec Supported Tools 文档 • Superpowers OpenCode 安装文档 如果这篇文章对你有帮助，欢迎点赞、收藏、关注！有问题欢迎在评论区讨论 🚀 🔗 原文链接： https://mp.weixin.qq.com/s/NeBSi Q8... https://mp.weixin.qq.com/s/NeBSi Q8... 原创 ElioYue ElioYue 程序猿的 AI 工坊2026年2月13日 15:41 辽宁 AI 编程三剑客：Spec Kit、OpenSpec、Superpowers 深度对比与实战指南 本文将深入介绍 GitHub 官方的 Spec Kit、社区热门的 OpenSpec 以及跨平台方法论工具 Superpowers 三个 AI 编程辅助工具，从安装配置到实战使用，再到三者协同的最佳实践，带你全面掌握 AI 驱动的规范化开发新范式。 前言：为什么需要这些工具？ 2024 2026 年，AI 编程工具经历了爆发式增长。从最初的代码补全，到如今的 AI Agent 自主编程，开发者面临一个核心问题： 如何让 AI 真正理解我们的意图，并按照预期的方式工作？ 三个工具应运而生，它们从不同角度解决这个问题： 工具 核心问题 类比 Spec Kit "按什么规矩干" 建筑规范手册 OpenSpec "改了什么" 施工变更单 Superpowers "怎么干" 施工队工作手册 工具 工具 核心问题 核心问题 类比 类比 Spec Kit Spec Kit "按什么规矩干" "按什么规矩干" 建筑规范手册 建筑规范手册 OpenSpec OpenSpec "改了什么" "改了什么" 施工变更单 施工变更单 Superpowers Superpowers "怎么干" "怎么干" 施工队工作手册 施工队工作手册 接下来，让我们逐一深入了解。 一、Spec Kit：GitHub 官方的规范驱动开发框架 1.1 简介 Spec Kit 是 GitHub 官方在 2025 年初推出的开源工具包，专为"规范驱动开发"（Spec Driven Development）设计。它的核心理念是： 先写规范，再写代码 。 • GitHub 仓库 ：https://github.com/github/spec kit • Stars ：69.1k ⭐ • 技术栈 ：Python (uv 包管理器) • 适用 AI ：Claude Code、Copilot Agent 等 1.2 核心概念 Spec Kit 引入了 分阶段的规范驱动开发流程 ，通过 5 个斜杠命令实现： constitution.md （宪法）：定义项目级别的治理原则 • 代码质量标准 • 测试规范 • 用户体验一致性要求 • 性能要求 spec.md （规范）：描述具体功能的需求 • 用户故事 • 功能需求 • 不涉及技术栈（关注 what 和 why） plan.md （计划）：技术实现方案 • 技术栈选择 • 架构设计 • API 契约 tasks.md （任务）：可执行的任务清单 • 从计划中提取的具体任务 • 实现步骤 1.3 安装教程 前置条件 • Python 3.11+ • uv 包管理器 • Git • 支持的 AI 编码助手（Claude Code、Copilot、Cursor 等） 安装步骤 一次性使用（无需安装） 初始化项目 支持的 AI 助手： • claude Claude Code • copilot GitHub Copilot • cursor agent Cursor • gemini Gemini CLI • windsurf Windsurf • codex Codex CLI • opencode opencode • qoder Qoder CLI • 以及更多 20+ 工具 初始化后的目录结构： 1.4 使用教程 步骤一：建立项目宪法 在 AI 助手中使用 /speckit.constitution 命令： 这会在 .specify/memory/constitution.md 中创建项目的治理原则。 步骤二：创建功能规范 使用 /speckit.specify 命令描述你想构建的内容（关注 what 和 why，不涉及技术栈）： 步骤三：创建技术计划 使用 /speckit.plan 命令提供技术栈和架构选择： 步骤四：分解任务 使用 /speckit.tasks 从实现计划创建可执行的任务清单： 步骤五：执行实现 使用 /speckit.implement 执行所有任务，按计划构建功能： 可选命令 命令 描述 /speckit.clarify 澄清规范中不明确的地方（推荐在 /speckit.plan 前使用） /speckit.analyze 跨工件一致性和覆盖率分析（在 /speckit.tasks 后、 /speckit.implement 前使用） /speckit.checklist 生成自定义质量检查清单 命令 命令 描述 描述 /speckit.clarify /speckit.clarify 澄清规范中不明确的地方（推荐在 /speckit.plan 前使用） 澄清规范中不明确的地方（推荐在 /speckit.plan 前使用） /speckit.analyze /speckit.analyze 跨工件一致性和覆盖率分析（在 /speckit.tasks 后、 /speckit.implement 前使用） 跨工件一致性和覆盖率分析（在 /speckit.tasks 后、 /speckit.implement 前使用） /speckit.checklist /speckit.checklist 生成自定义质量检查清单 生成自定义质量检查清单 示例：完整流程 假设要开发一个团队协作应用 Taskify： 1. 建立宪法 2. 定义规范 3. 技术计划 4. 分解任务 5. 执行实现 生成的文件结构： 二、OpenSpec：轻量级规范驱动开发工具 2.1 简介 OpenSpec 是由 Fission AI 团队开发的规范驱动开发（SDD）工具，专注于 灵活的、可自定义的工作流 。最新版本使用 OPSX 工作流 ，支持 20+ AI 编码助手。 • GitHub 仓库 ：https://github.com/Fission AI/OpenSpec • Stars ：23.7k ⭐ • 技术栈 ：TypeScript (npm) • 适用 AI ：Claude Code、Cursor、Windsurf、OpenCode、Codex、Copilot 等 20+ 工具 2.2 核心概念 OpenSpec 最新版本使用 OPSX 工作流 ，提供灵活的动作式工作方式，而非固定的阶段流程： 工作流程 ： 1. /opsx:new 开始新的变更（创建 proposal） 2. /opsx:continue 逐步创建工件（specs、design、tasks） 3. /opsx:apply 实施工阶段，执行任务并更新工件 4. /opsx:archive 归档完成的功能到知识库 5. /opsx:explore 探索想法，思考问题（可选） 6. /opsx:ff 快速前进，一次性创建所有规划工件 7. /opsx:sync 同步到主分支（可选） 2.3 安装教程 前置条件 • Node.js 20.19.0 或更高版本 • npm 或 pnpm（也支持 bun、yarn） 安装步骤 初始化项目 提示 ：初始化时会提示创建 openspec/config.yaml 项目配置文件，这是可选但推荐的。 2.4 使用教程 步骤一：创建配置文件（可选） 配置说明 ： • schema ：默认工作流模式（当前为 spec driven ） • context ：项目上下文，会注入到所有工件 • rules ：每个工件的具体规则 步骤二：创建新变更 AI 会询问： 1. 你想构建什么？ 2. 使用哪个工作流模式？ 生成的工件结构： 步骤三：逐步创建工件 每次调用会： 1. 检查哪些工件已准备好 2. 创建一个工件 3. 显示解锁的下一个工件 步骤四：快速前进 使用场景：当你已经清楚要构建什么，想要快速启动时。 步骤五：实施 AI 会： 1. 遍历 tasks.md 中的任务 2. 逐一实现 3. 实时更新任务状态 4. 如有问题，更新 specs/ 或 design/ 步骤六：归档 将变更移动到知识库： 步骤七：探索想法 这是一个思考伙伴，帮助澄清想法、比较选项、明确需求。 查看状态 返回： 三、Superpowers：Claude Code 的"施工队工作手册" 3.1 简介 Superpowers 是由 Jesse Vincent（obra）开发的 AI 编程方法论工具包，专注于 执行方法论 。它不是文档管理工具，而是一套让 AI 更高效、更可靠地执行编码任务的最佳实践集合，通过"技能"（Skills）系统引导 AI 像高级工程师一样工作。 • GitHub 仓库 ：https://github.com/obra/superpowers • Stars ：50k ⭐ • 技术栈 ：Markdown + JavaScript Plugin • 适用 AI ：Claude Code、OpenCode、Codex 3.2 核心概念 Superpowers 的核心是 "让 AI 像高级工程师一样工作" ： 3.3 安装教程 前置条件 • Bash 或 Zsh shell (macOS/Linux) • PowerShell 或 Command Prompt (Windows) Claude Code 用户（推荐方式） Claude Code 有插件市场，安装最简单： 看到 brainstorm 、 write plan 、 execute plan 这 3 个命令就说明安装成功。 OpenCode 用户 Windows 用户（PowerShell） Git Bash 用户 更新 Superpowers 卸载 看到 brainstorm 、 write plan 、 execute plan 这 3 个命令就说明安装成功。 OpenCode 用户 OpenCode 需要手动配置： Windows 用户（PowerShell）： Codex 用户 Windows 用户（PowerShell）： 更新 Superpowers 卸载 3.4 使用教程 Superpowers 工作原理 Superpowers 提供两种工作方式： 1. Commands（快捷命令） ：3 个可用命令 ◦ brainstorm 头脑风暴 ◦ write plan 编写计划 ◦ execute plan 执行计划 ◦ brainstorm 头脑风暴 ◦ write plan 编写计划 ◦ execute plan 执行计划 2. Skills（技能系统） ：AI 根据上下文自动加载合适的技能，无需记忆命令名称 推荐使用 ：自然语言描述需求，让 Superpowers 自动选择最合适的方式。 核心技能列表 技能名称 用途 brainstorming 在任何创造性工作前先头脑风暴，理解需求后再动手 subagent driven development 子代理驱动开发：为每个任务派发独立子代理 + 两阶段审查 executing plans 执行已制定的实施计划 finishing a development branch 完成开发分支：合并、创建 PR 或保留 requesting code review 请求代码审查 receiving code review 接收并处理代码审查反馈 systematic debugging 系统化调试：解决 bug 时使用 test driven development TDD 工作流：测试驱动开发 using git worktrees 使用 Git Worktree 创建隔离的工作空间 verification before completion 完成前验证：每步都要验证 writing plans 编写实施计划 writing skills 编写自定义技能 技能名称 技能名称 用途 用途 brainstorming brainsto