Agent Skills
› MageByte-Zero/spec-superflow
MageByte-Zero/spec-superflow
GitHub用于在构建受阻或遇到测试失败时，强制先进行根因调查再修复。包含四阶段流程：根因调查、模式分析、假设验证及实施，并规定三次失败后需升级至架构审查，防止盲目修补。
Install All Skills
npx skills add MageByte-Zero/spec-superflow --all -g -y
Skills in Collection (9)
用于在构建受阻或遇到测试失败时，强制先进行根因调查再修复。包含四阶段流程：根因调查、模式分析、假设验证及实施，并规定三次失败后需升级至架构审查，防止盲目修补。
spec-superflow执行中遇到bug或测试失败
build-executor遭遇阻塞
出现意外行为或性能问题
npx skills add MageByte-Zero/spec-superflow --skill bug-investigator -g -y
控制实现阶段，以执行合同为权威依据。支持TDD、分批实施及Git隔离检查。针对Full/Hotfix遵循合同优先与红绿重构原则，Quick模式按既定策略验证，确保代码纪律与变更安全。
用户希望进行受纪律约束的构建工作
需要执行TDD（测试驱动开发）流程
用户批准了execution-contract.md并请求分批次实施
npx skills add MageByte-Zero/spec-superflow --skill build-executor -g -y
用于代码审查，包括发起审查和响应反馈。需在任务、执行波次或合并前触发。通过调度子代理获取报告，依据严重等级（关键/重要/次要）处理反馈，强调验证后再实施，禁止盲目执行或无效回应。
SDD中的每个任务完成
计划执行波次结束
主要功能开发完成
合并代码前
遇到瓶颈时
重构前
修复复杂bug后
npx skills add MageByte-Zero/spec-superflow --skill code-reviewer -g -y
将审批后的规划产物转化为执行契约。当用户请求启动构建、从规划转入实施或契约缺失/过时时触发。通过映射提案、规格、设计和任务，生成包含意图、范围、约束及测试义务的execution-contract.md，并强制执行DP-3审批门禁。
用户要求开始构建
用户请求从规划阶段进入实施阶段
执行契约文件缺失或已过期
npx skills add MageByte-Zero/spec-superflow --skill contract-builder -g -y
在创建产物前澄清模糊需求，确定问题、范围、非目标及成功标准。通过单步提问和多选降低认知负荷，提供带权衡的建议方案，并在记录确认状态后移交，严禁直接生成代码。
用户需求模糊不清时
用户正在比较不同选项时
需要在编写产物前稳定变更定义时
npx skills add MageByte-Zero/spec-superflow --skill need-explorer -g -y
用于在 spec-superflow 变更执行结束时，通过状态守卫、分类验证（快速/完整路径）及审计检查，确保代码完成度与正确性，最终生成归档报告并安全关闭变更。
实现已完成且准备验证
用户请求最终总结或归档
npx skills add MageByte-Zero/spec-superflow --skill release-archivist -g -y
在变更从执行转为关闭前，将增量规范合并至主基线。校验状态为executing后，解析并应用增删改操作，检测冲突并生成报告，确保基线一致性且不删除历史文件。
变更处于执行状态且有待合并的增量规范
检测到多变更间的规范漂移
npx skills add MageByte-Zero/spec-superflow --skill spec-merger -g -y
用于在需求明确后生成规划工件。读取配置与决策，按序创建proposal、specs、design和tasks文档。严格遵循DP-0约束，确保需求可测试、设计有依据、任务无占位符，并需逐项确认以防止范围蔓延。
需要编写或完善项目规划文档时
变更已进入详细设计阶段，需生成proposal.md、specs/、design.md或tasks.md时
npx skills add MageByte-Zero/spec-superflow --skill spec-writer -g -y
spec-superflow工作流主入口，用于检测变更上下文、检查版本更新、扫描恢复状态并路由至对应技能。处理从探索到关闭的全生命周期，拦截无效转换，支持终端状态短路及执行控制恢复。
用户请求启动或继续spec-superflow工作流
当前目录存在.spec-superflow.yaml及相关工件
npx skills add MageByte-Zero/spec-superflow --skill workflow-start -g -y
