一、为什么需要这三件套在AI编程助手日益普及的今天你是否遇到过这些问题描述完需求后AI直接开始写代码方向跑偏缺乏文档沉淀做完即忘修改需求后AI“忘记”之前的上下文代码质量参差不齐缺乏统一规范Claude Code Superpowers OpenSpec的组合正是为解决这些痛点而生。它让AI从“随性编码”转变为“工程化开发”实现可追溯、高质量、可协作的AI辅助编程。二、三件套分别是什么三者的关系可以概括为OpenSpec管需求Superpowers管过程Claude Code管执行。工具核心定位一句话概括类比Claude CodeAI执行引擎在终端里帮你读写文件、运行命令的AI代理“双手”Superpowers行为与流程纪律层为Claude Code注入工程方法论的技能包“大脑”与“工作法”OpenSpec需求与规格管理层通过结构化文档管理需求和规格的框架“设计蓝图”2.1 Claude Code执行层双手Claude Code是Anthropic公司推出的命令行AI编程助手。你可以在终端中用自然语言与它交流它能帮你完成构建功能、修复Bug、重构代码等开发任务。核心能力理解整个代码库跨多文件编辑执行命令、运行构建破坏性操作前请求人工确认2.2 Superpowers行为纪律层大脑与工作法Superpowers是由开发者Jesse Vincent打造的开源插件核心理念是“流程大于提示词”——通过规范流程来保证AI的输出质量而非依赖更聪明的模型。核心机制内置20多种可组合的技能Skills强制AI在写代码前先思考、规划遵循测试驱动开发TDD、代码审查等工程纪律支持子代理Subagent并行开发大幅提升效率2.3 OpenSpec意图与规格层设计蓝图OpenSpec是一个规范驱动开发SDD框架解决AI“做什么”的问题。它像一份“设计蓝图”在动工前就把所有功能、接口、验收标准都规划好。核心机制在openspec/changes/目录下创建结构化提案包含proposal.md提案说明、design.md技术方案、tasks.md任务清单需求可追溯、可版本管理特别适合在已有项目上进行功能迭代三、安装指南开始前请确保已安装Node.js 20.19.0 或更高版本。3.1 安装 Claude Code根据操作系统在终端中执行对应命令macOS / Linuxcurl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell)irm https://claude.ai/install.ps1 | iex或使用 Homebrew (macOS)brew install --cask claude-code或使用 NPMnpm install -g anthropic-ai/claude-code安装后执行claude --version看到版本号即表示成功。3.2 安装 OpenSpec# 全局安装 npm install -g fission-ai/openspeclatest # 进入项目目录 cd your-project # 初始化 OpenSpec openspec init初始化时会引导你选择AI助手选Claude Code并在项目中创建openspec/和.claude/等目录。3.3 安装 SuperpowersSuperpowers 需要在已启动的 Claude Code 会话中安装而非系统终端# 在 Claude Code 会话中依次执行 /plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace安装完成后输入/exit退出并重新启动 Claude Code看到“Superpowers loaded successfully”的提示即表示激活成功。四、协同工作流从UX图到代码假设你已经有了UX设计图和RESTful API文档接下来展示如何让三件套协同工作实现“先分析→再文档→后代码”的完整流程。4.1 OpenSpec定义“做什么”规范阶段第一步是将UX图和接口文档转化为结构化的、AI可执行的规范。提示词示例/openspec:proposal 根据项目中的UX设计图 [路径/UX-设计图.png] 和 RESTful API 文档 [路径/API-文档.md]为“用户管理列表页”创建一份变更提案。 要求 1. 分析输入仔细分析UX图提炼出所有功能点搜索、分页、表格列、操作按钮等。对照API文档明确每个功能对应的接口URL、Method、Request/Response数据结构。 2. 产出文档在 openspec/changes/add-user-list/ 目录下生成 - proposal.md说明为什么要做这个功能 - design.md怎么做组件结构、数据流、状态管理等 - tasks.md实施清单 3. 增量规格使用 ADDED Requirements 和 ADDED Scenarios 来描述新增功能并包含具体的验收场景。 4. 确认后执行在我确认这些文档无误之前不要开始编写任何代码。产出效果Claude Code会调用OpenSpec在openspec/changes/add-user-list/目录下生成完整的需求文档、技术方案和任务清单。4.2 Superpowers规划“怎么做”计划阶段当OpenSpec的规范确认后让Superpowers将规范文档拆解成更细致、可执行的编码任务。提示词示例/superpowers:write-plan 基于 openspec/changes/add-user-list/ 目录下的规范为“用户管理列表页”生成一份详细的编码计划。 要求 1. 任务拆解将开发工作拆解为2-5分钟即可完成的小任务。 2. 明确细节每个任务需要明确涉及的文件名如 src/views/UserList.vue、核心职责和验收标准。 3. 合理排序按照正确的开发顺序排列任务如定义TypeScript类型 → 编写API调用函数 → 开发UI组件 → 联调。产出效果生成一份详细、可执行的plan.md文档将“用户管理”拆解为数十个具体、可执行的编码任务。4.3 Claude Code Superpowers执行“动手做”编码阶段最后让Claude Code按照Superpowers制定的计划执行编码。此时Superpowers的TDD测试驱动开发、代码审查等纪律会自动生效。提示词示例/superpowers:execute-plan 请按照刚刚生成的编码计划开始执行。从第一个任务开始逐项完成。 执行原则 1. TDD驱动对于核心逻辑请遵循“先写测试再写实现”的原则。 2. 进度汇报每完成一个任务简要汇报进度。 3. 质量自检任务完成后进行代码审查。产出效果AI有条不紊地逐个完成任务。对于复杂项目Superpowers会启动多个子代理并行开发不同部分最后合并代码。五、核心Skill速览Superpowers内置了20多种可组合的技能以下是几个关键技能技能名称核心作用触发时机brainstorming需求澄清通过苏格拉底式提问把模糊想法变清晰任何新需求的起点writing-plans任务拆解将设计文档分解为可执行的小任务方案确认后subagent-driven-development并行开发为独立任务创建子代理并行工作大型复杂项目test-driven-development测试先行先写测试再写功能代码核心业务逻辑systematic-debugging根因分析结构化流程定位Bug根源调试排错writing-skills自定义技能创建专属Skill团队规范沉淀六、提示词策略总结6.1 从“指令型”到“目标型”类型示例问题指令型不推荐“帮我写一个登录页”AI直接写代码需求不明确目标型推荐“我需要开发登录功能请先分析需求输出设计文档再编码”强制AI走完整流程6.2 万能提示词模板目标[用一句话描述你要解决的问题或构建的功能] 输入材料 - UX设计图[文件路径] - API文档[文件路径或Swagger地址] 约束条件 1. 请先完成需求分析和方案设计输出文档 2. 在我确认文档后再拆解任务、制定计划 3. 最后按计划逐步实现编码 4. 每个阶段都与我确认后再进入下一阶段 技术要求[可选] 技术栈、框架版本、编码规范等七、最佳实践与注意事项7.1 使用建议从小处着手先从一个独立的小功能如一个列表页开始实践善用文档沉淀openspec/目录下的文档可追溯、可版本管理及时确认每个阶段完成后及时确认避免方向偏差逐步深入复杂项目时Superpowers会自动调用更多技能7.2 常见问题与解决问题解决方案使用指令型提示词改用目标型提示词强调“先分析再编码”跳过文档阶段用/openspec:proposal强制创建规范文档一次性描述过多需求分阶段迭代逐步完善AI忽略UX图细节在提示词中明确引用图片路径要求“提取设计规范”八、总结Claude Code、Superpowers和OpenSpec三者协同形成了一条完整的AI辅助前端开发流水线OpenSpec负责“定义要做什么”需求与规范Superpowers负责“规划怎么做”任务拆解与流程纪律Claude Code负责“动手去实现”编码执行通过这套组合你可以将AI辅助开发从随性的“聊天模式”升级为严谨、可追溯、高质量的工程模式。