SuperAPI AI 工具集

hotfix

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:hotfix 是一个紧急修复(emergency fix)工作流技能,用于对紧急缺陷快速实施最小化、针对性的修复。它跳过头脑风暴文档和规划文档,但测试与评审不可省略。

主要能力与流程:需要先提供缺陷描述,否则不能继续。Phase 0 分诊:用一句话总结缺陷,识别症状与疑似涉及层面。Phase 1 定位:调用 @codebase-review-agent 聚焦定位相关代码,阅读相关文件并给出根因,若根因不明则向用户追问。Phase 2 分支:通过 git rev-parse --abbrev-ref HEAD 判断当前分支,若不在 hotfix/ 分支则创建 hotfix/<kebab-slug> 分支(slug 由缺陷描述推导,总长不超过 60 字符),并请用户确认。

Phase 3 修复:先做爆炸半径检查(blast radius check),若涉及超过 5 个文件、多个层面或需要新抽象,则警告用户并询问是继续 hotfix 还是改用 /plan;若在阈值内则直接修复。实施时只做必要改动,不做顺手重构,越界问题以 // TODO(hotfix): 注释记录。测试不可省略:需新增或更新可复现该缺陷的测试(未修复时应失败),覆盖修复路径与相关边界。

Phase 4 评审:并行运行 @vgv-review-agent 与 @test-quality-review-agent,报告写入 docs/hotfix-review/ 下的 vgv-review.md 与 test-quality-review.md,处理发现后删除该目录。Phase 5 交付:最后运行格式化、lint 与测试;创建单个便于 cherry-pick 的提交,提交信息以 fix: 开头并说明根因与原始缺陷;推送分支并创建 PR。

限制与注意事项:绝不跳过测试,不添加与缺陷无关的功能(YAGNI),若修复超出原范围应停下并标记。热修复可有意接受较小副作用(如修 P0 同时接受 P2),但需用 TODO(hotfix) 注释并写入 PR 说明。热修复分支使用 hotfix/ 前缀而非 fix/。若缺陷位于共享依赖或工具,修改前需 grep 所有使用处;若需要数据库、配置或 schema 迁移,通常已超出热修复范围,建议改用 /plan → /build。其他未提及的功能、收费或平台支持暂未提供。