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或批量开发。强制Git工作区隔离以防止误提交，支持Full/Hotfix/Tweak等多种工作流模式，确保编码纪律与分支安全。
用户希望基于已批准的执行契约进行 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
将审批通过的计划工件转化为执行契约（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
负责在变更执行阶段进行最终验收、验证与归档。通过状态守卫确保仅在执行中运行，支持快速路径或完整清单验证，确保测试、构建及代码一致性达标后安全关闭变更。
实现完成且准备收尾
正在进行最终验证
用户请求最终总结
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
变更进入规划阶段需生成 planning pack
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
