Agent Skills
› MageByte-Zero/spec-superflow
MageByte-Zero/spec-superflow
GitHub系统化排查技术故障的 Skill，强调先定位根因再修复。包含根因调查、模式分析、假设验证及实施四个阶段，并在三次修复失败后触发架构级升级检查，防止盲目修补。
安装全部 Skills
npx skills add MageByte-Zero/spec-superflow --all -g -y
集合内 Skills (9)
系统化排查技术故障的 Skill，强调先定位根因再修复。包含根因调查、模式分析、假设验证及实施四个阶段，并在三次修复失败后触发架构级升级检查，防止盲目修补。
遇到 Bug 或测试失败
构建执行器被阻塞
出现意外行为
npx skills add MageByte-Zero/spec-superflow --skill bug-investigator -g -y
基于执行契约规范代码实现，强制执行TDD、分支隔离及变更控制。适用于全量开发、热修复及快速修补场景，确保实施纪律与质量验证。
用户希望按照已批准的执行契约进行规范的代码构建
需要执行严格的TDD（测试驱动开发）流程
请求受控的批量实现或快速热修复
npx skills add MageByte-Zero/spec-superflow --skill build-executor -g -y
用于代码审查的 Skill，负责请求审查并执行反馈。包括分发子代理、记录 SHA、生成报告及根据严重级别处理修复或推回，确保代码符合规范与质量要求。
执行批次完成后
合并前
工作流到达审查节点时
npx skills add MageByte-Zero/spec-superflow --skill code-reviewer -g -y
将审批后的规划工件（提案、规格、设计等）转换为执行契约，确保需求覆盖与范围约束。用于启动构建或从规划转入实施阶段，需用户明确批准后方可执行。
用户要求开始构建
请求从规划阶段转入实施阶段
执行契约文件缺失或过时
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
用于生成或优化软件规划工件，包括提案、规格说明、设计文档和任务列表。基于DP-0决策确认状态，按配置顺序创建符合规范的文档，确保需求可测试、设计有依据、任务依赖清晰。
需要编写proposal.md时
需要定义specs/规范时
需要制定design.md设计时
需要生成tasks.md任务计划时
npx skills add MageByte-Zero/spec-superflow --skill spec-writer -g -y
作为spec-superflow工作流入口，检测上下文并检查更新。识别变更状态，处理终端状态短路，执行恢复扫描与执行控制检查，支持直接短路径接入，将任务路由至对应技能以规范开发流程。
用户处于active spec-superflow变更目录并要求开始或继续工作流
用户显式请求启动新的spec-superflow变更或路由工作流
npx skills add MageByte-Zero/spec-superflow --skill workflow-start -g -y
