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)
系统化故障排查技能，强制先定位根因再修复。涵盖错误分析、复现、模式对比及假设验证四阶段，防止盲目修补，确保根本解决技术问题。
遇到bug或测试失败
构建执行受阻
出现意外行为
npx skills add MageByte-Zero/spec-superflow --skill bug-investigator -g -y
作为构建执行者，依据批准的执行合同规范代码实现。强制分支隔离，遵循TDD流程（红-绿-重构），并在逻辑缺陷或范围漂移时触发审查与回滚，确保 disciplined build work。
用户希望进行纪律严明的批量代码实现
需要执行 TDD 开发流程
基于已批准的执行合同进行受控构建
npx skills add MageByte-Zero/spec-superflow --skill build-executor -g -y
负责代码审查流程，包括请求子代理审查实现合规性与质量，以及接收并处理反馈。涵盖触发时机、SHAs获取、报告持久化及基于严重程度的修复策略。
执行批次完成后
合并前
工作流达到审查门控时
npx skills add MageByte-Zero/spec-superflow --skill code-reviewer -g -y
将审批通过的计划工件转换为执行契约，触发于启动构建或规划转实施时。读取提案、规格、设计等文档，提取意图、范围、需求及约束，生成标准化的执行握手文件并强制要求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
用于在变更执行完毕时进行最终验证、总结和归档。通过状态守卫和快速/完整检查清单，确保测试、构建及需求满足，提供证据以安全关闭变更流程。
实现完成且准备验证
用户请求最终收尾工作
npx skills add MageByte-Zero/spec-superflow --skill release-archivist -g -y
在变更关闭前将增量规范同步至主规范基线，确保状态为执行中，处理冲突检测及增删改操作，保障规范一致性。
变更即将关闭需合并增量规范时
检测到多个变更间存在规范漂移时
npx skills add MageByte-Zero/spec-superflow --skill spec-merger -g -y
用于生成和细化项目规划工件，包括提案、规范、设计和任务清单。在需求明确后，依据决策约束自动生成结构化文档，确保需求可测试、设计有依据、任务有依赖，并支持校验与评审流程。
需要编写或完善 proposal.md, specs/, design.md, tasks.md 等规划文档时
变更进入详细规划阶段，且 DP-0 决策已确认时
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
