用途:write-fix 用于执行一个缺陷修复任务,在基础 implement-task 规则之上增加修复纪律。它消费一份缺陷报告并产出修复,而不是撰写报告(撰写报告对应 write-bug-report);若问题是偶发失败测试,应改用 fix-flaky-test。
主要能力与要求:先在本地工作树中复现缺陷并粘贴失败输出,无法复现时不应打补丁,环境差异本身应作为发现或阻塞项上报。修补根因而非症状,打补丁前用自己的话说明该位置为何是原因而非失败显现处。回归测试必须在修复前失败、修复后通过,需粘贴两次状态转换,并断言缺陷破坏的行为而非内部状态。运行完整测试套件并粘贴输出,避免修好一个测试却破坏相邻功能。保持修复最小化,不捆绑其他缺陷或重命名,相关发现只作为总结中的候选。总结中用一两句话说明补丁为何解决根因。命令需从 AGENTS.md 解析,未定义时询问,不得猜测测试命令,也不得对自己的工作出具评审结果。
根因排查:对第一个看似合理的解释保持怀疑,从可观察失败回溯到产生它的状态与输入,将原因锚定到 file:line,并说明期望与实际及期望依据。无法复现时改变负载、并行、种子、时钟、数据状态等条件继续排查。
限制:这些是评审包检查的约定,编辑时没有强制机制。资料未提供具体安装命令、平台、收费或价格信息。