连通需求说清楚和代码写对路的 AI 编程工作流插件。整合 OpenSpec 规划 + Superpowers 纪律，7 平台支持，Spec-first，契约驱动。
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/MageByte-Zero/spec-superflowGuides for using cli tools skills like spec-superflow.
用 AI 写代码时，最常碰到两个失控点：
还没想清楚要做什么，AI 就开始写代码。 你说了句"帮我加个权限控制"，它就开始改几十个文件。改到一半才发现 —— 到底要 RBAC 还是 ABAC？
规划文档写得明明白白，但执行阶段还是会跑偏。 proposal 写了、design 画了，但实现过程中没人盯着测试、没人卡 review，等到合并才发现行为不对。
spec-superflow 在两个失控点之间用源码级的引擎 + 桥接协议建立起一道硬墙：
spec-explorer 先把需求问清楚 -> spec-forger 把意图沉淀为正式工件（Schema 引擎验证格式）-> bridge-contract 把规划压缩成执行契约 execution-contract.md -> execution-governor 以 TDD + SDD + Review Gate 三重纪律强制执行 -> systematic-debugger 处理执行中的阻塞 -> code-reviewer 审查每批产出 -> closure-archivist 验证后收口 -> spec-syncer 同步 delta spec 防止规范腐烂。
它不是把 OpenSpec 和 Superpowers 并排安装再手工拼接，而是把两者的核心引擎和能力吸收进一个自包含的工作流 owner。
| 设计原则 | 说明 |
|---|---|
| Spec First | 没有稳定的规划工件，不允许进入实现 |
| Guarded Handoff | execution-contract.md 是规划到实现的唯一交接层 |
| Strong Guardrails | 实现过程中违反契约的行为被明确拦截并回退 |
| Schema Validated | 规划期工件经过 Schema 引擎验证，不合格不允许进入桥接 |
| Execute Disciplined | TDD 铁律 + SDD 子代理驱动 + Review Gate 双重审查 |
| Self-Contained | 不需要运行时安装 OpenSpec 或 Superpowers，一个插件全包 |
| 场景 | 原因 |
|---|---|
| 大型功能开发 | 需要明确的规划、审查、测试门禁，防止实现偏离设计 |
| 多人协作项目 | execution-contract.md 提供明确的协作合约和审查标准 |
| 长期维护项目 | spec-syncer 防止规范腐烂，delta spec 机制支持持续演进 |
| 需要 TDD + Review Gate | 内置 TDD 铁律 + SDD 子代理驱动 + 双重审查 |
| 棕地项目（brownfield） | spec-explorer 先检查现有代码，再规划变更 |
| 需要规划稳定性检查 | bridge-contract 确保规划稳定后才进入实现 |
| 场景 | 原因 | 建议 |
|---|---|---|
| 快速原型 / Demo | 工作流太重，token 消耗大 | 直接用 Claude Code 默认行为 |
| 小改动（< 100 行） | 9 个 skill + 7 状态过度设计 | 直接改代码 + 测试 |
| 探索性开发 | 规划会频繁变化，合约会反复失效 | 用 spec-explorer 单 skill，不走完整流程 |
| 个人实验项目 | 审查门禁和归档流程是负担 | 用 Superpowers 或 OpenSpec 单一框架 |
| 纯 Bug 修复 | 不需要规划阶段 | 用 systematic-debugger 单 skill |
| 学习/实验新工具 | 工作流会限制探索自由度 | 直接动手实验 |
如果一个改动你不需要写 proposal 和 design doc 就能想清楚，那 spec-superflow 可能太重了。
简单判断：如果你会在团队周会上花 5 分钟以上解释这个改动，那 spec-superflow 是值得的。
触发入口是 workflow-orchestrator。
每次开始或恢复一个变更，你只需要告诉 Agent 一句话：
用 workflow-orchestrator 开始
workflow-orchestrator 会检查当前工件目录，内容级检测（不只是检查文件是否存在，还比较 proposal 范围 vs 契约意图锁），判断你处于哪个阶段，然后自动路由到正确的下一个 skill。
你说"帮我加一个权限控制"
│
▼
┌──────────────────┐
│ workflow-orchestrator │ ← 唯一入口。内容级状态检测、路由到正确 skill
└──────┬───────────┘
│
▼
exploring spec-explorer 追问："你要 RBAC 还是 ABAC？" "多大粒度？"
│ 一次一个问题，2-3 方案对比，推荐最佳并解释原因
▼
specifying spec-forger 产出 4 份工件 + Schema 引擎实时验证
│ proposal + specs + design + tasks
│ 不合格 → 拒绝，指出问题 → 修订后重新验证
▼
bridging bridge-contract 解析引擎自动提取 → 压缩为 execution-contract.md
│ ┌────────────────────────────────────────────┐
│ │ execution-contract.md │
│ │ - Intent Lock (从 proposal 自动提取) │
│ │ - Approved Behavior (从 specs 自动提取) │
│ │ - Design Constraints (从 design 自动提取) │
│ │ - Task Batches (从 tasks 自动提取) │
│ │ - Test Obligations & Review Gates │
│ └────────────────────────────────────────────┘
│
◇ 用户批准 ◇ ← 唯一一次人工介入：你看一眼，确认，然后说"批准"
│
▼
executing execution-governor
│ ├─ TDD 铁律: NO PRODUCTION CODE WITHOUT FAILING TEST
│ ├─ SDD: 子代理实施 → 双重审查(spec合规+代码质量) → 修复 → 重新审查
│ ├─ Review Gate: 每批次完成后 code-reviewer 审查
│ └─ 进度台账: .superpowers/sdd/progress.md 防会话压缩丢失
│
├──[遇到 bug]──→ debugging
│ systematic-debugger
│ 4 阶段根因分析: 根因 → 模式分析 → 假设验证 → 实现修复
│ 3+ 次修复失败 → 质疑架构 → 升给用户
│
▼
closing closure-archivist
│ 验证前完成铁律: NO COMPLETION CLAIMS WITHOUT FRESH EVIDENCE
│ 运行测试 → 读输出 → 确认通过 → 才说完成
│
▼
syncing spec-syncer (如果存在 delta spec)
ADDED/MODIFIED/REMOVED/RENAMED → 智能合并到主规范
冲突检测: 多个变更同时改同一个 capability
关键约束：
execution-contract.md 或未被用户批准 → 不允许进入实现specifying 或 bridging，不在执行阶段悄悄改市面上 AI 编程工作流基本是两派：
| 流派 | 代表 | 优势 | 短板 |
|---|---|---|---|
| 规划派 | OpenSpec | 产出清晰的 proposal、specs、design、tasks，有 Schema 验证引擎 | 只管写文档，不管执行。文档写完了，实现阶段还是裸奔 |
| 纪律派 | Superpowers | TDD、SDD、review gate、系统化调试、验证铁律 | 没有正式的规划工件层和 Schema 验证，对"需求是否已经明确"缺乏硬判断 |
spec-superflow 不是"两边都装"，而是"去重叠、留异同、加独创"：
OpenSpec 独有 ──────→ 吸收 Superpowers 独有 ──────→ 吸收
Schema 引擎 TDD 铁律 (RED-GREEN-REFACTOR)
Delta Spec (ADDED/MODIFIED) SDD (子代理驱动 + 双层审查)
三维度验证 (verify-change) 系统化调试 (4 阶段根因分析)
Spec 同步 (sync-specs) 结构化代码审查 (三级问题分级)
批量归档冲突解决 验证前完成铁律
并行代理调度
│
┌───────────────────────────────────────┼───────────────────────────────────────┐
│ spec-superflow 独创 │
│ │
│ 🔗 桥接层 execution-contract.md — 解析引擎自动提取 4 工件 → 1 份可检查契约 │
│ 🧭 内容级状态检测 — 不只是检查文件存在，还比较 proposal scope vs contract lock │
│ 🚦 7 状态机 — exploring/specifying/bridging/approved/executing/debugging/closing │
│ 🧩 9 skill 协同 — 入口路由 → 澄清 → 锻造 → 桥接 → 执行 ⇄ 调试 → 审查 → 收口 → 同步 │
│ │
│ 每个 skill 背后有真实的引擎代码： │
│ - src/schema/ ← OpenSpec 基因: Requirement, Delta, Spec 类型定义 │
│ - src/validation/ ← OpenSpec 基因: 验证器 (SHALL/MUST, Scenario, Delta) │
│ - src/parsing/ ← OpenSpec 基因: Requirement 块解析 + Delta Spec 解析 │
│ - scripts/ ← Superpowers 基因: task-brief, review-package 辅助工具 │
│ - hooks/ ← Superpowers 基因: session-start 多平台引导注入 │
│ - implementer/reviewer 模板 ← Superpowers 基因: SDD 双层审查提示模板 │
└──────────────────────────────────────────────────────────────────────────────┘
| # | Skill | 阶段 | 职责 | 来源 |
|---|---|---|---|---|
| 1 | workflow-orchestrator |
入口 | 内容级状态检测、7 状态路由、阻止非法跳转 | 独创 |
| 2 | spec-explorer |
探索 | 一次一问+方案对比+推荐。嵌入 brainstorming 提问法 | 融合增强 |
| 3 | spec-forger |
规格 | 产出 proposal/specs/design/tasks。Schema 引擎实时验证 + writing-plans 粒度 | 融合增强 |
| 4 | bridge-contract |
桥接 | 解析引擎自动提取 4 工件 → 压缩为 execution-contract.md | 独创 |
| 5 | execution-governor |
执行 | TDD 铁律 + SDD 子代理驱动 + Review Gate。内嵌 implementer/reviewer 模板 | 融合增强 |
| 6 | systematic-debugger |
调试 | 4 阶段根因调试。3+ 修复失败 → 质疑架构 | ← Superpowers |
| 7 | code-reviewer |
审查 | 结构化审查，三级问题分级，禁止表演性同意 | ← Superpowers |
| 8 | closure-archivist |
收口 | 验证前完成铁律 + 归档 + 风险总结 | 融合增强 |
| 9 | spec-syncer |
同步 | Delta Spec (ADDED/MODIFIED/REMOVED/RENAMED) → 主规范智能合并 | ← OpenSpec |
官方直接支持 Claude Code / Cursor / OpenAI Codex CLI / OpenAI Codex App / GitHub Copilot CLI / Gemini CLI。
另外，任何支持本地 skills/ 目录的客户端，都可以用“通用本地安装”方式接入，例如 OpenCode、Trae、Qoder、Trae CN，或其他可配置技能目录的 IDE。
| 平台 | 安装方式 | 备注 |
|---|---|---|
| Claude Code | /plugin marketplace add MageByte-Zero/spec-superflow + /plugin install spec-superflow@spec-superflow |
推荐，零拷贝 |
| Cursor | /add-plugin spec-superflow |
也可在插件市场搜索安装 |
| OpenAI Codex CLI | codex plugin marketplace add MageByte-Zero/spec-superflow + codex plugin add spec-superflow@spec-superflow |
已补 .codex-plugin/ 和 .agents/plugins/ |
| OpenAI Codex App | 先用 CLI 添加 marketplace，再从 Plugins 面板安装/启用 |
不在 OpenAI curated 目录里 |
| GitHub Copilot CLI | copilot plugin marketplace add ... + copilot plugin install ... |
适合 CLI 用户 |
| Gemini CLI | gemini extensions install https://github.com/MageByte-Zero/spec-superflow |
支持 update |
| OpenCode / Trae / Qoder / Trae CN / 其他本地技能客户端 | 克隆仓库后把 skills/ 指向客户端的本地技能目录 |
本仓库提供 .agents/skills -> ../skills 入口 |
所有平台安装方式见 INSTALL.md。
v0.6.0spec-superflow 是自包含插件，不需要在运行时单独安装 OpenSpec 或 SuperpowersCHANGELOG.mdspec-superflow 版本记录功能基线，而不是要求用户先安装上游工具在 Claude Code / Cursor 中安装 hooks 后，每次会话启动自动注入 workflow-orchestrator：
# Claude Code 自动加载 hooks/hooks.json
# Cursor 自动加载 hooks/hooks-cursor.json
这样每次新会话开始时，Agent 自动知道 spec-superflow 已就绪。
安装完成后，告诉 Agent：
Agent 会自动检查当前工件，内容级判断处于哪个阶段。
除了 skill 工作流，spec-superflow 还提供独立的 CLI 工具：
# 全局安装后可直接使用 ssf 命令
npm install -g spec-superflow
# 或在项目中通过 npx 使用
npx spec-superflow list
| 命令 | 功
spec-superflow is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by MageByte-Zero. 连通需求说清楚和代码写对路的 AI 编程工作流插件。整合 OpenSpec 规划 + Superpowers 纪律，7 平台支持，Spec-first，契约驱动。. It has 60 GitHub stars.
spec-superflow's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/MageByte-Zero/spec-superflow" and add it to your Claude Code skills directory (see the Installation section above).
spec-superflow is primarily written in JavaScript. It is open-source under MageByte-Zero on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh spec-superflow against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars