开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

社区首页 >专栏 >规格驱动开发（SDD）：如何用 Claude Code + OpenSpec + Superpowers 在历史项目中落地

规格驱动开发（SDD）：如何用 Claude Code + OpenSpec + Superpowers 在历史项目中落地

作者头像

sunnying

修改于 2026-05-18 12:02:32

修改于 2026-05-18 12:02:32

1090

举报

概述

你在历史项目里做过“看似小改动、结果引发连锁回归”的经历吗？存量代码库往往体量大、模块边界模糊、测试并不总是可靠；再叠加人员流动，很多关键知识只存在于少数人的脑子里：为什么这个字段不能删？为什么某个 Service 改动必须同时清缓存？为什么这个接口返回 200 但其实是业务失败？当你尝试在这种项目里引入 AI 辅助编码，如果没有一套可复现的规范化流程，很容易退化成“Vibe Coding”。

文章被收录于专栏：AI CodingAI Coding

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯云开发者社区

腾讯云架构师技术同盟

AI时代的架构师

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯云开发者社区

腾讯云架构师技术同盟

AI时代的架构师

评论

登录后参与评论

0 条评论

热度

最新

目录

Claude Code 规格驱动开发（SDD）最佳实践（Claude Code + OpenSpec + Superpowers）
- 引言
  - 一图看懂：在存量项目里复现 SDD 的闭环
- 环境搭建：工具与插件的完整安装配置
  - 1）一张表跑通安装路径
  - 1.5）把“表格”变成逐条可复制的命令
    - 步骤 1：安装 Claude Code CLI
    - 步骤 2：安装并初始化 OpenSpec
    - 步骤 3：安装并启用 Superpowers 插件（在 Claude Code 交互界面执行）
    - 步骤 4：初始化 CLAUDE.md（在 Claude Code 交互界面执行）
    - 步骤 5：创建自定义 Skills 目录
    - 步骤 6（可选）：准备 MCP（外部系统）连接配置
  - 2）常见问题（每步都能对号入座）
  - 3）CLAUDE.md 初始模板（复制即用）
- 阶段 1——建立项目 Constitution
  - 补充：把 Constitution 当成“可执行契约”，而不是“项目介绍”
  - 1）进入交互模式
  - 2）生成 CLAUDE.md 草稿
  - 3）人工审查与增强（按清单逐项补全，含填写示例）
  - 4）提交到版本库
  - 5）验证：让 AI 解释结构并自证准确
- 阶段 2——需求规格化：从模糊需求到结构化 Spec
  - OpenSpec 的变更生命周期（你要追求“每次都能走完”）
  - 1）创建变更目录（可复现入口）
  - 2）生成规格草案（让 AI 先扫代码，再写 Spec 结构）
  - 2.5）补一段“可落地”的状态机定义（避免实现时各写各的）
  - 3）交互式澄清：用 /clarify 把“含糊点”问死
  - 4）审核确认：锁定规格
- 阶段 3——技术方案设计与任务拆解
  - 1）生成技术方案：执行 /spec:plan
  - 1.5）把 Plan 审查变成“可操作的 Gate”
  - 2）方案审核：用“通过/不通过”做强约束
  - 3）任务拆解：执行 /spec:tasks
- 阶段 4——逐任务实现、验证与归档
  - Mermaid：Superpowers 期望的 TDD 循环（不符合就停）
  - 1）开始实现：按任务范围执行
  - 2）Superpowers 介入：你应该看到的行为序列（示例）
  - 3）开发者介入点：T003 后手动测 API，问题用 /fix 回到 TDD
  - 4）全量验证：跑原有测试 + 对齐规格
  - 5）归档：让“这次学到的东西”变成下次可复用的规范
- 避坑指南与可重复实践清单
- 结语