Agent Skills
› MageByte-Zero/spec-superflow
MageByte-Zero/spec-superflow
GitHub用于在遇到bug、测试失败或意外行为时进行根本原因调查，遵循先排查后修复的原则，包含四个阶段以系统化定位问题。
Install All Skills
npx skills add MageByte-Zero/spec-superflow --all -g -y
Skills in Collection (9)
用于在遇到bug、测试失败或意外行为时进行根本原因调查，遵循先排查后修复的原则，包含四个阶段以系统化定位问题。
执行过程中出现bug
测试用例失败
构建或集成失败
遇到未预期的行为
npx skills add MageByte-Zero/spec-superflow --skill bug-investigator -g -y
执行已批准或计划中的代码变更，支持原生连续实现与遗留流程。涵盖预检、分支隔离及执行策略选择，确保合规提交。
用户请求执行已批准的代码变更
需要运行构建或部署脚本
处理遗留系统的发布流程
npx skills add MageByte-Zero/spec-superflow --skill build-executor -g -y
用于审查代码实现是否符合规范及质量要求。在合并前或工作流审查节点触发，执行Git范围审查、生成报告并根据发现结果决定通过或失败，支持波次和最终审查。
完成实施批次后
合并前
达到工作流审查门控时
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
用于发布流程收尾的 Skill，在实现完成或验证阶段调用。负责执行最终验证、检查合同与测试覆盖、同步规格文档、运行审计并归档结果，支持风险接受模式，确保变更闭环。
实现已完成且需进行最终验证
用户请求最终收尾工作
变更处于执行或关闭状态需逻辑闭合
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约束并具备可测试性。
需要创建或完善项目规划文档时
需求已明确进入规划阶段
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
