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
用于在代码合并前或工作流节点触发时，请求审查子代理对实现进行合规性与质量检查，并指导如何严谨地接收、验证及处理审查反馈。
执行批次完成且准备合并前
达到工作流中的审查门禁
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
在变更执行阶段完成最终验证、摘要与归档准备。通过状态守卫确保仅在executing状态下运行，支持快速路径或完整清单验证（测试、完整性、一致性等），确保证据充分后安全关闭变更流程。
实现完成且需最终验收
正在进行验证工作
用户请求最终收尾归档
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工作流的主入口技能，用于在检测到相关上下文时启动、继续或恢复变更流程。负责检查更新、验证状态机转换、执行覆盖层与执行控制恢复扫描，并路由至正确的子任务。
用户要求开始、继续或恢复 spec-superflow 工作流
当前目录存在 .spec-superflow.yaml 及相关工件
npx skills add MageByte-Zero/spec-superflow --skill workflow-start -g -y
