事后复盘

事故复盘 生成结构化、无指责的事故复盘报告，支持时间线重建、日志分析和行动项跟踪。

快速开始 # 从零创建复盘（自动填充模板章节） python3 scripts/generate_postmortem.py --title "数据库宕机" --severity P1

# 解析日志，自动提取时间线事件 python3 scripts/generate_postmortem.py --title "API 延迟" --log /var/log/app.log --since 2h

# 从 JSON 加载完整事故 python3 scripts/generate_postmortem.py --from incident.json --output html -o postmortem.html

# 合并日志 + 人工时间线 python3 scripts/generate_postmortem.py --title "部署失败" --log /var/log/deploy.log --timeline events.json

# 检查现有文档是否含指责性语言 python3 scripts/generate_postmortem.py --check-blame existing-report.md

功能 日志解析 — 自动识别 syslog、JSON、Apache/Nginx、Python traceback、Docker、通用时间戳格式，提取错误、警告及关键事件到时间线。 时间线重建 — 合并日志事件与人工时间线 JSON，按时间排序并标注事件类型（检测、行动、升级、解决）。 无指责语言 — 内置检查器扫描指责性措辞并给出替换建议；对任意文档使用 --check-blame。 严重度分级 — P0（致命）至 P3（轻微），附带对应描述。 多格式输出 — Markdown（默认）、HTML（带样式）、JSON（结构化）。 CI 友好退出码 — 0（干净）、1（发现错误）、2（严重级别）。 模板章节 — 摘要、影响、时间线、根因、检测、解决、经验教训、行动项。

选项 Flag Default 说明 --title 必填 事故标题 --severity P2 P0、P1、P2 或 P3 --date today 事故日期 --duration TBD 持续时长 --summary — 简短摘要 --log — 日志路径（可重复） --since all 日志时间过滤（1h、24h、7d） --timeline — 时间线 JSON 文件 --from — 从 JSON 加载完整事故 --output markdown 输出格式：markdown、html、json -o stdout 输出文件路径 --check-blame — 检查文件是否含指责性语言

工作流 事故发生后 收集日志：--log /var/log/app.log --log /var/log/nginx/error.log --since 4h 生成草稿：python3 scripts/generate_postmortem.py --title "..." --severity P1 --log ... -o draft.md 补全模板章节（摘要、根因、影响、解决） 运行指责检查：--check-blame draft.md 添加行动项并分享

基于结构化数据 创建 incident.json（详见 references/templates.md 中的 schema） 生成：--from incident.json --output html -o postmortem.html

定期复盘 使用 JSON 输出跟踪多个复盘的行动项完成情况。

参考资料 templates.md — 完整 JSON schema、时间线事件类型、无指责语言指南及替换建议