关于 spec-first-superpowers
面向功能开发、修复和重构的规格优先工作流技能，要求在实现前先确认规格，并按项目情况选择 Spec-Kit 或 OpenSpec。它还将持久化规划、测试驱动开发和分阶段质量门纳入流程。
主要功能
- 01自动选择 Spec-Kit 或 OpenSpec
- 02按任务复杂度分级流程
- 03规格确认后再进入实现
- 04生成持久化计划与进度记录
- 05通过质量门和 TDD 检查
适用场景
- 01为新功能建立并确认规格
- 02规划跨模块改动和重构
- 03通过质量门推进 Bug 修复
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/spec-first-superpowers确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
assets/constitutions/openspec-constitution.mdspec-kit-constitution.mdreferences/integration-guide.mdmempalace-integration.mdopenspec-workflow.mdquality-gates.mdspec-kit-workflow.mdsynergy-patterns.mdupgrade-protocol.md详细介绍
Spec-First + Superpowers Orchestrator v5
阻止 AI 直接开始编写代码。每个功能、错误修复和重构都必须先经过规格说明阶段——因为未经审视的代码代价高昂。
命令
| 命令 | 效果 |
|---|---|
/super-spec | 完整工作流（自动模式 + 自动复杂度） |
/super-spec force-spec-kit | 强制使用 Spec-Kit 模式 |
/super-spec force-openspec | 强制使用 OpenSpec 模式 |
/super-spec reset | 重置模式选择 |
/super-spec upgrade | 检查所有集成项目是否有更新，并执行升级 |
工作原理
步骤 1：选择模式
先检查现有信号，再根据启发式规则选择：
| 信号 | 模式 |
|---|---|
.spec-mode 文件存在 | 使用文件中的设置 |
.specify/ 目录 | Spec-Kit |
openspec/ 目录 | OpenSpec |
| 全新项目，文件数 < 30 | Spec-Kit |
| 其他所有情况 | OpenSpec（默认） |
将选择保存到 .spec-mode，以便后续会话记住。
详细的模式工作流请参阅：
- Spec-Kit：references/spec-kit-workflow.md
- OpenSpec：references/openspec-workflow.md
步骤 2：评估复杂度
AI 建议级别；用户确认或更改。
| 级别 | 适用情况 | 执行内容 |
|---|---|---|
| Quick | 单文件错误修复、拼写错误、配置 | 简化规格说明（/opsx:propose 或 /opsx:ff）→ TDD → 归档 |
| Standard | 单个功能、范围明确 | 执行所有阶段（仅 UI 场景需要阶段 3） |
| Thorough | 多模块、架构决策 | 执行所有阶段 + 评估 Agent Teams |
步骤 3：执行流程
阶段 0 — 会话恢复（自动）
如果存在上一会话的 task_plan.md，则读取所有规划文件，查询 MemPalace 中的相关历史记录（如果已配置），运行 5 问重启测试（我现在在哪里？/ 我要去哪里？/ 目标是什么？/ 我学到了什么？/ 我做了什么？），然后从上一个检查点继续。
阶段 1 — 规格说明
使用所选模式编写规格说明。Quick 任务使用 /opsx:propose；Standard/Thorough 任务使用完整流程，通过 /opsx:explore 或 /speckit.specify 执行。用户必须明确确认规格说明后才能继续。
关卡 G1：用户已确认 + 规格说明符合规范 + 行内规格审查通过 + 已完成范围检查。
阶段 2 — 持久化规划
使用 planning-with-files + writing-plans 生成 task_plan.md（包含文件结构映射和测试点的编号清单）、findings.md 和 progress.md。
关卡 G2：每项任务都包含文件路径、验收标准、测试策略，且行内计划审查已通过。
阶段 3 — UI/UX 设计（条件触发）
仅在检测到 UI 关键词时触发。调用 ui-ux-pro-max --design-system --persist，生成并持久化设计系统（v2.5.0：67 种样式、161 种调色板、57 种字体、14 种技术栈、6 种专业技能）。
关卡 G3：交付前检查清单已通过 + 用户已确认设计。
阶段 4 — 实施 通过两种策略之一执行（AI 提出建议，用户选择）：
- Subagent-Driven：每项任务启用全新的子 Agent + 两阶段审查（规格符合性 → 代码质量）+ 根据任务角色选择模型 + 实施者状态处理（DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED）
- Executing-Plans：批量执行 + 检查点审查
全程采用 TDD。错误通过 3-Strike 协议升级处理 → systematic-debugging。
关卡 G4：所有测试通过 + 审查通过 + 验证证据已写入 progress.md + /opsx:verify 已通过（如果可用）+ MemPalace 已归档（如果已配置）。
阶段 5 — 归档
finishing-a-development-branch → 更新所有复选框 → 归档规格说明产物 → 在 progress.md 中添加最终条目 → 在 MemPalace 中记录日记条目（如果已配置）。
质量关卡
每个关卡都是硬性停止点——所有检查通过前，不得继续推进。如果关卡未通过，请修复问题并重新评估。完整的关卡标准请参阅：references/quality-gates.md
防止仓促推进
如果用户要求跳过规范阶段，请礼貌拒绝，并引导其使用 /super-spec。此技能的核心目的就是防止过早实施。
参考文件
根据需要阅读这些文件——其中包含的详细流程会让本文档变得臃肿：
| 文件 | 阅读时机 |
|---|---|
| references/quality-gates.md | 评估任何关卡（G0-G4）时 |
| references/synergy-patterns.md | 了解跨工具集成（6 条链路）时 |
| references/integration-guide.md | 配置、故障排除和依赖项列表 |
| references/spec-kit-workflow.md | 执行 Spec-Kit 流程 |
| references/openspec-workflow.md | 执行 OpenSpec 流程 |
| references/mempalace-integration.md | 配置 MemPalace 记忆系统 + 5 个集成点 |
| references/upgrade-protocol.md | /super-spec upgrade — 标准化版本同步流程 |
| assets/constitutions/openspec-constitution.md | OpenSpec 宪章模板 |
| assets/constitutions/spec-kit-constitution.md | Spec-Kit 宪章模板 |