Claude Code / Trae Workflow Plugin
spec-superflow
连通"需求说清楚"和"代码写对路"的 AI 编程工作流引擎
The Problem
AI 编程的两个失控点
用 AI 写代码时，最常碰到的两个问题，恰好分别发生在动手之前和动手之后。
// PAIN POINT 01
方向失控
还没想清楚要做什么，AI 就开始写代码。你说"帮我加个权限控制"，它就开始改几十个文件。改到一半才发现 —— 到底要 RBAC 还是 ABAC？
// PAIN POINT 02
质量失控
规划文档写得明明白白，但执行阶段还是会跑偏。proposal 写了、design 画了，但实现过程中没人盯着测试、没人卡 review，等到合并才发现行为不对。
The Solution
在两个失控点之间架一座硬桥
STEP 1-2
澄清 & 规划
need-explorer
spec-writer
→
BRIDGE
execution
contract
契约层
→
STEP 4-6
执行 & 收口
build-executor
release-archivist
spec-superflow 不是把 OpenSpec 和 Superpowers 并排安装再手工拼接，而是把两者最有价值的部分吸收进一个统一的工作流引擎。
State Machine
6 状态管线：每一步都有硬约束
没有稳定规划工件 → 不允许进入实现 | 违反契约 → 拦截回退 | 需求变更 → 强制回退到对应规划阶段
Skills
6 个协作 Skill，各司其职
入口
workflow-start
检查当前状态、路由到正确的 skill、阻止非法跳转
探索
need-explorer
澄清意图、范围、约束、成功标准，把模糊需求变明确边界
规格
spec-writer
生成 proposal、specs、design、tasks 四份正式规划工件
桥接
contract-builder
把规划工件压缩为可检查的 execution-contract.md
执行
build-executor
强制 TDD、评审关卡、契约优先实现，违规即拦截
收口
release-archivist
验证完成度、生成变更总结、准备归档
Design Principles
四大设计原则
Spec First
没有稳定的规划工件，不允许进入实现。把"先想清楚再动手"从口号变成硬约束。
Guarded Handoff
execution-contract.md 是规划到实现的唯一交接层，所有模糊决策在这里被显式压缩为可验证条目。
Strong Guardrails
实现过程中违反契约的行为被明确拦截并回退，而不是靠开发者"感觉不对"来手动纠偏。
Self-Contained
不需要运行时安装 OpenSpec 或 Superpowers，即装即用，零运行时依赖。
Key Innovation
execution-contract.md：不只是一份文档
这是 spec-superflow 区别于其他工作流工具的核心。它不是又一份规划文档，而是一份可检查的契约。
// execution-contract.md
Input / Output
明确本次变更的输入、输出、边界条件
Test Checklist
逐条对应该通过的测试用例
Review Gates
预定义验收关卡和 escalation 规则
让 AI 编程从随机游走变成可控流水线
开源、自包含、即装即用。支持 Claude Code 和 Trae。
GitHub
->