Agent Skills
› MageByte-Zero/spec-superflow
MageByte-Zero/spec-superflow
GitHub遵循“先定位根因后修复”原则，通过四阶段系统化流程（调查、分析、假设测试、实施）排查代码缺陷、测试失败及构建错误，强调科学调试与架构反思。
安装全部 Skills
npx skills add MageByte-Zero/spec-superflow --all -g -y
集合内 Skills (9)
遵循“先定位根因后修复”原则，通过四阶段系统化流程（调查、分析、假设测试、实施）排查代码缺陷、测试失败及构建错误，强调科学调试与架构反思。
遇到代码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
负责代码审查流程，包括调度子代理进行合规与质量检查，以及基于反馈严谨修复问题。支持在合并前或工作流节点触发，依据严重程度处理Critical/Important/Minor反馈，确保代码质量与安全。
执行批次完成后
合并前
达到工作流中的审查关卡时
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决策约束，按配置顺序产出符合规范的artifacts，确保需求可测试且架构决策有据可依。
需要撰写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
