debrief

debrief 是一个事故复盘技能，用于在事故、失败发布或重大缺陷之后，趁上下文新鲜生成结构化的无责复盘文档，包含时间线、根因和可执行的后续事项。\n\n用途与触发场景：生产事故、失败发布、不稳定的部署或重大缺陷发生后，团队需要理解原因并防止复发时使用。技能会采集事件上下文；若上下文为空，会先询问用户发生了什么、相关 PR/提交或错误日志，未获得描述前不继续。\n\n主要流程与能力：通过 AskUserQuestion 一次一个问题补齐信息，涵盖影响、时间、平台环境、严重程度、发现方式、解决方式与参考链接；并行从代码库收集证据，如受影响文件的 git log、git log --all --oneline、gh pr view、gh run list、gh run view 及测试覆盖与变更频率分析；综合证据定位根因与促成因素，采用无责框架，问“什么让这成为可能”而非“谁造成的”；生成具体、可指派、尽量关联代码的后续事项，分为 Prevent（预防）、Detect（检测）、Respond（响应）三类，仅记录在文档中，另行建单。\n\n使用方式：写作前检查当前分支，若运行 git rev-parse --abbrev-ref HEAD 显示处于 main、master 或 develop 等基础分支，会询问是否创建特性分支，如 git checkout -b <type>/<kebab-topic>（名称不超过 60 字符）；文档写到 docs/debriefs/YYYY-MM-DD-<kebab-case-topic>-debrief.md，需先确保目录存在。完成后可选择用结构化评审完善文档，或读取后续事项生成可复制的 GitHub issue 草稿：存在 .github/ISSUE_TEMPLATE/ 时读取其中 yaml/yml（跳过 config.yml）并匹配模板，否则使用通用格式；预览仅展示，不调用 gh、glab 等 CLI。\n\n限制：技能不修改代码，只产出文档。允许部分信息，缺失处需显式标注而非阻塞。输出对语言和框架无假设。文档结构、严重程度取值、模板内容等细节暂未提供。