用途:在调试明确落地并验证修复后,为其他工程师(以及半年后遗忘一切的自己)留下修复的规范化工程记录。不用于假设性复盘、客户可见的故障/事故(那需要独立的事件报告),以及琐碎修复(如笔误)——这类情况应拒绝或先确认。
必要输入(缺一不可,否则列出缺失项并停止,不得起草):可靠可复现的复现步骤(确定性或高频不稳定复现,而非“有时出现”)、已知根因(机制已识别,非假设)、修复已确定(PR/提交/分支指针)、修复已验证(原复现通过,客户工作负载或失败测试成功)。
主要结构(按序):1 摘要(必填);2 症状;3 根因(必填,代码标识符欢迎并预期保留);4 为何产生该症状;5 修复(必填);6 如何被发现;7 为何漏过(如 CI 缺口、潜伏代码、工作负载缺口、先前修复不完整、评审遗漏,或诚实说明无好理由,且无责);8 验证(必填,如实说明覆盖范围,只测一种配置就明说);9 行动项/后续(含负责人与跟踪物,无则如实写无)。
语气:工程师对工程师,代码标识符为一等公民,讲机制而非叙事,主动语态,无模糊措辞,无责,不夹带主张。
输出流程:确认四项输入齐备;确认去处(默认源工单的 JIRA 评论,也可为 PR 描述、docs/postmortems/<ticket>.md、内部 wiki);以单个聊天块产出草稿;发布到 JIRA 前需明确批准并展示 ADF 载荷,仅打印输出无需批准;可提出转交 management-talk 但不得自动执行。规则:缺输入不得起草,不得编造根因、负责人、验证运行或行动项,不得删除代码标识符,JIRA 发布需签核,仅输出打印无需批准,不得向非 JIRA 目标发布。