bug-fix-brief 是把缺陷修复整理成简短说明文档的 Skill。它记录环境、实际与预期行为、复现步骤、根因位置和方案选择,再列可验证的修复事项。
例如空邮箱触发异常,报告要说哪个输入、哪个版本、怎样到达出错点。文件行号帮助定位,仍需核控制流,不能把最后报错的一行直接当根因。
比较方案时写清代价与理由,别为了凑两项虚构可行性。主文示例把一个改法称作“零影响”,实际还要确认错误语义、调用者和测试,改动少不说明影响为零。
适合修复前把决定交给实现与复核者。本文未生成真实缺陷报告或修改代码;清单项完成要有测试和原复现路径的结果,编号和模板整齐不等于问题已经解决。