AI 编程三件套：Spec Kit 协同实战

Spec Kit Superpowers ECC 最佳项目实践指南摘要本文系统介绍了 Spec Kit规范治理、Superpowers工程质量和 ECC能力增强三款 AI 编程工具的组合实践方法。通过 Spec Kit 的 SDD 工作流确保按规范做Superpowers 的 TDD 和验证机制确保把东西做对ECC 的 agents 和 hooks 确保有能力做好。文章详细阐述了三组件的核心机制、完整配合流程、场景决策矩阵和快速参考为中型以上功能开发、多人协作和长期维护项目提供了完整的 AI 辅助编程解决方案。AI 写代码越来越强但随之而来的是三个新问题规范问题AI 知道该按什么标准写吗质量问题写完的代码怎么验证它真的对能力问题AI 能不能持续学会项目的上下文这三个问题正好对应三个工具Spec Kit 解决规范问题Superpowers 解决质量问题ECC 解决能力问题。它们单独用都还说得过去但组合在一起效果是乘法级的。之前写过一篇有简单介绍这一篇继续迭代加深印象。AI 编程的痛点不在于 AI 写不对而在于写完没人知道合不合规范、质量可不可信。本文介绍 Spec Kit规范治理 Superpowers工程质量 ECC能力增强三件套的实战配合方法覆盖从项目初始化到代码收尾的完整流程。1. 三组件定位组件本质来源Spec KitSpec-Driven Development 工具包 CLIgithub/spec-kitSuperpowers工程方法论体系15 skillsobra/superpowersECCClaude Code 增强插件Everything Claude Code核心分工Spec Kit → 治理层Constitution SDD 工作流确保按规范做 Superpowers → 工程层TDD 验证 审查确保把东西做对 ECC → 能力层agents hooks 持续学习确保有能力做好2. Spec Kit 核心机制SDD 工作流8 步Constitution → Specify → Clarify → Plan → Validate → Tasks → Implement → ConvergeSlash 命令速查命令职责/speckit.constitution创建项目宪法编码质量、测试标准、安全规则/speckit.specify定义需求用户故事 FR 成功标准What/speckit.clarify消除需求歧义Plan 前必执行/speckit.plan技术方案架构、数据模型、API 规格How/speckit.tasks依赖排序的任务列表[P]标记可并行/speckit.implementAI agent 按 tasks.md 执行/speckit.converge评估代码与规格的差距生成关闭任务关键概念Constitution项目宪法、PrimitivesExtensions/Presets/Overrides 三级覆盖、Bundles角色预配置包、CLIspecify init/bundle/extension产出物.specify/memory/constitution.md ← 项目宪法 specs/001-feature/ spec.md ← 需求 用户故事 成功标准 plan.md />3. Superpowers 核心机制Skill铁律 / 关键规则brainstorming一次一个问题2-3 方案分段确认writing-plans精确文件路径 完整代码2-5 分钟/步using-git-worktrees必须验证 gitignore 后才创建subagent-driven-development规格合规审查 → 代码质量审查不可颠倒executing-plans批量执行3 任务 检查点test-driven-development无失败测试不写代码verification-before-completion无验证证据不言完成systematic-debugging根因 → 模式 → 假设 → 修复3 次失败质疑架构requesting-code-review每任务/批次后派发 code-reviewerfinishing-a-development-branch测试不过不合并4 选项收尾dispatching-parallel-agents仅用于独立问题域4. ECC 核心机制命令Agent产出/plan-prd—.claude/prds/{name}.prd.md/planplanner.claude/plans/{name}.plan.md/tddtdd-guideTDD 引导实现/code-reviewcode-reviewer代码审查/security-scansecurity-reviewer安全报告/build-fixbuild-error-resolver构建修复/learn//evolve—持续学习Hookssession-start/end跨会话记忆、pre-compact/suggest-compact压缩管理Rulescommon/通用 语言特定TS/Python/Go/Java/Kotlin始终生效5. 完整配合流程阶段一项目治理Spec Kitspecify init → /speckit.constitution → .specify/memory/constitution.md阶段二需求工程Spec Kit/speckit.specify → spec.md用户故事 FR 成功标准 /speckit.clarify → 消除歧义更新 spec.md阶段三技术规划Spec Kit/speckit.plan → plan.md >阶段四实现细化Superpowersbrainstorming → docs/plans/YYYY-MM-DD-design.md细化实现方案 writing-plans → docs/plans/YYYY-MM-DD-feature.md极细粒度步骤阶段五执行三组件协同环境git worktreeSuperpowers ECC hooks/rules 自动生效 每任务循环 1. 按 writing-plans 步骤执行Superpowers TDD 铁律 2. 阻塞 → systematic-debuggingSuperpowers / /build-fixECC 3. 完成 → verification-before-completionSuperpowers 4. 审查 → 规格合规对齐 Spec Kit spec.md→ 代码质量 5. 标记完成下一任务 全部完成 → /speckit.converge 评估差距阶段六收尾finishing-a-development-branchSuperpowers4 选项收尾 /speckit.taskstoissues可选转 GitHub Issues /learn /evolveECC 持续学习6. 场景决策矩阵场景Spec KitSuperpowersECC修 typo / 配置✗✗✗简单 bug✗✓ debugging TDD✓ rules小型功能1-3 文件✗✓ brainstorming TDD✓ rules中型功能4-10 文件可选✓ 核心✓ agents大型功能10 文件✓ 完整✓ 完整✓ 完整多人协作✓ 完整✓ 完整✓ rules 共享7. 快速参考文件产出总览.specify/memory/constitution.md ← Spec Kit: 项目宪法 specs/001-feature/spec.md ← Spec Kit: 需求 specs/001-feature/plan.md ← Spec Kit: 技术方案 specs/001-feature/tasks.md ← Spec Kit: 任务分解 docs/plans/YYYY-MM-DD-design.md ← Superpowers: 设计细化 docs/plans/YYYY-MM-DD-feature.md ← Superpowers: 极细粒度计划 .claude/prds/{name}.prd.md ← ECC: PRD .claude/plans/{name}.plan.md ← ECC: 计划 .worktrees/branch/ ← Superpowers: 隔离环境铁律清单铁律来源所有产物对齐 ConstitutionSpec Kit每阶段用户确认后才进入下一阶段Spec Kit无失败测试不写生产代码Superpowers TDD无验证证据不言完成Superpowers verification规格合规审查先于代码质量审查Superpowers3 次修复失败 → 质疑架构Superpowers debugging测试不过不合并Superpowers finishing三组件对比维度Spec KitSuperpowersECC本质SDD 工具包 CLI工程方法论AI 增强插件核心治理 规格驱动代码质量 纪律能力增强 自动化需求产物spec.md故事FR标准design.md细化.prd.md计划粒度任务级步骤级2-5分/步阶段级治理文档constitution.md无无TDD支持排序铁律可选审查无双阶段单次差距评估converge无无跨会话无无hooks学习CLIspecify系列无无用了这套组合拳三个月最大的变化不是代码写得有多快而是我敢说这代码能上线了。以前 AI 写的代码我心里永远有个万一。万一测试覆盖不够万一它跳过了边界条件万一 PR 审查的人看不出来这些万一现在都有机制兜底Constitution 管住了该不该写TDD 管住了对不对双阶段审查管住了好不好。但我必须说这套流程不是银弹。如果你只是修个 typo、改个配置别走这套流程纯属浪费时间。如果是一个人做的小脚本Spec Kit 的完整工作流也显得太重。这套东西最适合的场景是中型以上功能、多人协作、代码需要长期维护。还有一个心得别一上来就把三个工具全配齐。我的建议是先装 ECC零成本hooks 和 rules 装完就生效然后引入 Superpowers 的 TDD 和 verification 两个 skill最后再上 Spec Kit 的完整工作流。渐进式地加每个阶段适应一两周团队才不会抗拒。说到底这些工具不是替代你的判断力而是帮你把不放心变成有据可查。AI 写的代码不再是黑盒每一步都有迹可循。这才是它们真正的价值。基于 Spec Kit、Superpowers、ECC编写作者唐悦玮 | 从后端出发用 AI 拓展到全栈的工程师。