事故复盘（Incident Postmortem）风格规范解析：在 ppt-master 中以 Style 工作区落地 Blameless 复盘方法

事故复盘（Incident Postmortem）风格规范解析：在 ppt-master 中以 Style 工作区落地 Blameless 复盘方法

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master

本文围绕仓库内置的 incident-postmortem 风格设计规范 展开：它定义了"无指责事故复盘"这一可复用沟通方法及其配套设计默认值，适用于生产事故复盘、宕机报告、质量与安全调查、安全事件简报与可靠性回顾等场景。读完本文，你将掌握该规范七大部分的完整内容——论证流程、页面角色词汇表、证据与数据表达纪律、视觉系统默认值、图像图标方向与复盘检查清单——并理解它在 ppt-master 的 Style 工作区契约、注册发现机制与模板校验工具链中的准确位置。

一、定位：一份"方法 + 设计默认值"的 Style 规范

在阅读规范正文前，先厘清它在仓库中的契约位置。incident-postmortem位于 skills/ppt-master/templates/styles/ 目录，是kind: style类模板工作区之一。按照 styles/README.md 的定义：

Style = 一份不含页面清单（roster-free）的可复用沟通方法 + 协调一致的设计默认值：论证流程、页面角色词汇表、证据与数据表达纪律、视觉系统默认值、图像/图标方向、复盘检查焦点。

关键边界是：Style 不拥有当前项目的沟通契约、品牌身份、页面几何、SVG 原型或应用契约，也不替代mode（叙事骨架）与 visual-style（视觉风格）目录。

规范文件本身的 frontmatter 严格遵循 design_spec.md 契约：

--- style_id: incident-postmortem kind: style summary: Blameless incident review method that reconstructs a timeline, separates contributing factors from blame, and commits to verifiable actions. keywords: [postmortem, incident, reliability, root-cause, blameless] ---

契约要求 frontmatter 只允许style_id、kind: style、summary、keywords（三到五个发现标签）四个字段。该规范以incident-postmortem为键注册在 styles_index.json，它是该风格唯一的发现来源——按 styles/README.md 所述，styles_index.json映射style_id → { summary, keywords }，仅凭口头提及风格名不会激活工作区，必须经确认流程显式安装。

规范开头还以注释形式声明了它的边界："Method and design defaults only. No project communication contract, brand identity, page structure, or SVG prototypes."（仅方法与设计默认值，不包含项目沟通契约、品牌身份、页面结构或 SVG 原型）。这解释了为什么该目录下只有 design_spec.md 一个文件——Style 工作区只有一个文件，不带页面或资产载荷。

二、Style Overview：风格概览

规范第 I 部分用一张表格给出了核心属性：

两个要点值得展开。其一，Best Fit 描述的是"可复用选择情境"而非绑定受众/结果——这是 Style 与 Deck 的本质区别。按照 create-template.md 的输入解释规则，Style 输入可以是一段直接的 brief、文本、文档或网页，从中提取论证流程、主张纪律、页面角色词汇表、数据表达规则与视觉默认值，但绝不能变成当前项目的受众、目标、大纲、页数或主张。

其二，Sources 行标注了来源类型。仓库 create-style.md 规定 Style 的资产引用保持为文本形式的出处（textual provenance），这也与"Style 工作区只有一个文件"的规则一致——不会创建images/、icons/、exports/目录。

三、Communication Method：无指责沟通方法

3.1 首选模式：briefing

规范 II 部分第一行声明Preferred Mode: briefing。根据 modes/_index.md，mode 是 deck 的"叙事 + 说服骨架"，而 briefing 模式 的完整定义是：

中性信息传递。平实而完整地铺陈事实，组织成便于扫描和查找的结构——没有要论证的论点、没有要讲的故事、没有要构建的教训、没有奇观。

这与事故复盘天然契合：复盘文档的价值在于"完整、中立、可检索"，而非推销一个结论。briefing 模式还给出三条直接影响复盘的纪律：

• 主题式标题而非断言式标题：每页标题只命名其主题（如"检测与告警时间线"），而非"检测延迟是事故主因"——这与 pyramid 模式的断言标题正好相反；
• core_message 陈述覆盖范围而非主张：在填写design_spec.md §IX时，core_message写"本页铺陈了什么"，而非"本页证明了什么"；
• 完整优于选择性：包括受众需要扫描的完整参考集，而不仅仅是支持某一立场的点。

3.2 论证流程（Argument Flow）

规范给出的论证流为：陈述发生了什么及其代价 → 从检测到恢复重建时间线 → 审视是什么让故障得以发生并持续未被发现 → 承诺针对这些条件的变更。并强调"事实先于解读，解读先于行动；深度跟随严重程度而非固定的报告模板"。

这一顺序本身就是无指责复盘的核心操作：它把"发生了什么"（事实层）与"应该发生什么"（判断层）严格分离，确保受众在接受事实之前不会被迫面对分析结论。

3.3 页面消息纪律（Page Message Discipline）

• 每页一个事实、一个因素或一个行动，页面标题即该页所确立的内容；
• 每条时间线条目必须带时间戳、来源和时区；
• 严禁在同一页混合"发生了什么的重建"与"应该发生什么的判断"——受众必须能在权衡分析之前先接受事实。

3.4 主张纪律（Claim Discipline）

这是规范中分量最重的部分，六条规则环环相扣：

1. 始终区分已观测事件、推断序列、促成因素与假设，任何未确认内容必须标注"未确认"；
2. 描述各时刻人们所知所见，而非事后诸葛式的显而易见；
3. 将结果归因于条件与系统，而非个体——点名角色与系统，不点名有过失的人；
4. 报告实际影响，而非最能保护团队的估计；
5. 底层条件未消除时，不得将因素标记为已解决；
6. 事实与解读分离，承诺的行动必须可验证。

四、Page Role Vocabulary：页面角色词汇表

规范第 III 部分定义了 11 个页面角色，每个角色都绑定三项内容：沟通任务（Communication Job）、证据义务（Evidence Obligation）、构图倾向（Composition Tendency）。完整表格如下：

值得注意两点。第一，create-style.md 强调Page Role Vocabulary 是词汇表而非名册（roster）：它不规定顺序、状态、数量、文件名、身份、槽位或内容策略。第二，"What went well" 角色的存在是 blameless 方法的完整形态——复盘不仅要学习失败，还要保护那些限制了损害的实践，单列失败清单会教出错误的教训。

五、Evidence & Data Expression：证据与数据表达纪律

5.1 论证溯源（Argument Trace）

规范要求建立一条完整可追溯的证据链：

• 每条时间线条目溯源到带来源名称的日志、告警、消息、工单或人工叙述；
• 每个促成因素溯源到时间线证据；
• 每个行动溯源到一个因素；
• 若叙述依赖回忆而非记录，必须如此标注。

5.2 图表（Charts）

• 使用与时间线同一时钟、同一时区的时间序列图，并在坐标轴上标注检测、升级、缓解与恢复点；
• 展示足够的事前历史以确立正常行为，保持坐标刻度不中断，并标注每个偏差对应的含义；
• 绝不裁剪窗口让异常看起来更小或恢复看起来更快。

5.3 表格（Tables）

• 表格用于时间线、影响分解与行动承诺；
• 保持统一的行形态；时间线时间戳精度一致并声明时区；
• 每个行动记录负责人、日期、验证方法及其针对的因素；
• 估计的影响数字显式标注。

5.4 来源（Sources）

• 每条日志摘录、指标或图表附带系统、查询与检索时间；
• 时区声明一次、放在显眼处，并全篇一致使用；
• 区分自动记录与人工回忆；
• 注明证据何时丢失、被轮转或不可用。

5.5 原生可编辑性（Native Editability）

• 时间线与行动承诺优先使用可编辑的原生表格，因为复盘关闭后它们仍会被追踪与更新；
• 监控图与日志摘录作为原始保真度的截取证据保留，而非重新绘制——重绘的图不再是记录。

这条规则与 ppt-master 的原生能力一脉相承：该项目将文档或主题转为真正的原生 PowerPoint 幻灯片，支持原生形状、过渡与动画、数据支撑的图表与表格（参见仓库 README.md 的项目描述）。原生表格的可编辑性直接服务于"复盘后仍需持续追踪行动项"的真实工作流。

六、Visual System Defaults：视觉系统默认值

6.1 首选视觉风格：swiss-minimal

规范声明Preferred Visual Style: swiss-minimal。swiss-minimal 参考 是仓库中最克制的视觉风格：严格瑞士网格纪律、模块化网格、锐利几何、激进留白、近零装饰。它与复盘的亲和力是结构性的：

• 形状语言：偏好锐利精确的原生轮廓、正圆、单粗细规则线与少量大面积几何平面；默认直角，任何圆角几乎不可感知；
• 装饰：省略没有信息或构图职责的装饰——无装饰性渐变、装饰块或徽章，结构本身承载页面；
• 留白：广阔而有意识，负空间与内容同等重要；
• 扁平：严格扁平，无阴影、无深度、无材质——二维概念平面。

6.2 构图、密度与装饰

• 构图：每页围绕一个事实构建；时间线的空间方向在反复出现处保持一致；为时间戳、事件与来源固定稳定位置，以便读者用眼睛比较条目；概要、系统性条件与行动页留足空间，证据页在单一网格下承载密度；
• 密度：文档在会后由不在场的人阅读，页面必须独立成立；概要页与因素页要一目了然，时间线与证据页要承载真实细节，不隐藏条目、不截断标识符；
• 装饰：实际上为零。"这是事实记录；视觉克制是其可信度的一部分。"只用发丝线规则、清晰分隔与一致的标记；避免警报图形、戏剧性红色渐变、警告装饰，以及任何给承载证据的页面增加情绪重量的装置。

6.3 色彩行为

• 保持中性底色，将色彩保留给声明的严重程度与状态；
• 映射关系在整份文档中固定，并与组织现有的严重程度标度一致（如存在）；
• 严重程度颜色必须配标签，以保证打印与色觉差异下依然可读；
• 绝不用颜色暗示过失，或为页面修辞性加权重；
• 任何已确认的 Brand 或 Deck 身份会替换这些倾向。

6.4 Fallback Color Scheme（回退配色方案）

规范 V 部分末尾给出完整的回退色板，它属于"优先级更低的默认值，绝不等于身份"：

这套色板的设计语义非常明确：七种颜色中五种（Field/Surface/Ink/Normal）是中性功能色，只有三种状态色（Degraded/Critical/Recovered）承载严重程度含义，且每种状态色都必须在文字标签的陪伴下使用。按照 styles/README.md 与 create-style.md 的规则，回退色板是条件性子章节（conditional），没有字面色值时可省略；若提供了 Brand 或 Deck 身份，会以一次决策替换重叠的回退颜色、字体、语气与图标身份，但不会抹掉方法本身。

6.5 字体特征（Typography Character）

• 使用朴素的中性无衬线字体，配真正等宽的伴侣字体用于时间戳、标识符、日志摘录与命令；
• 全篇保持时间戳精度与格式一致；
• 日志文本不换行且保持可读；
• 层级由字重与对齐派生，而非容器；
• 确切字体族属于当前项目或已解析的身份决策。

swiss-minimal 参考 补充了字体特征细节：单一家族无衬线，常规/粗体对比，紧密严谨的字距，强大小层级——大标题、小且精确的正文，左对齐齐头。字体族在确认阶段按主题契合度选择，该风格要求的是 grotesque/neo-grotesque性格而非特定字体。

七、Image & Icon Direction：图像与图标方向

7.1 首选图像渲染：digital-dashboard

规范声明Preferred Image Rendering: digital-dashboard。digital-dashboard 渲染参考 描述的是打磨过的 UI/数据可视化美学：图像看起来像产品或分析仪表盘的截图——干净卡片、柔和阴影、克制的排版、图表类视觉元素。它适用于 SaaS 演示、数据产品展示与 B2B 分析 deck。

该渲染方向与"监控屏、告警状态、仪表盘截图作为证据"的复盘需求直接对应：仪表盘审美天生承载"这确实是当时屏幕上所见的记录"的可信感。

7.2 图像使用（Image Usage）

图像只作为证据使用——监控画面、告警状态、错误输出、配置或相关的物理状况。绝不在事故记录中插入概念性或氛围性图像。

这是规范最严格的图像纪律：复盘文档中任何一张装饰性、情绪性的图片都会削弱整份记录的客观性。

7.3 图像处理（Image Treatment）

• 呈现的截取证据除裁剪外不得改动，时间戳与坐标轴标签在渲染的幻灯片尺寸下保持可见可读；
• 只对个人数据或凭证做脱敏，且每处脱敏都要标记；
• 用系统、查询与时区作为说明文字；
• 避免全出血（full-bleed）处理，避免在生成的图像中出现合成文字。

7.4 图标处理（Icon Treatment）

• 少用图标，仅用于标记严重程度、状态或事件类别；
• 使用同一族系图标与固定映射；
• 绝不让图标独自承载必须在打印后仍存活的严重程度信息；
• 绝不在事实记录中使用表情性或情绪化图标。

八、Review Focus：复盘检查清单

规范最后一部分是 Review Focus，带有一个特殊的触发标记：

<!-- visual-review-trigger: explicit-user-only -->

按照 styles/README.md 的契约，Review Focus 必须包含恰好一个visual-review-trigger: explicit-user-only标记，且该标记不可本地化。其语义是：本节仅在用户显式激活视觉复盘后应用，绝不自行触发该阶段。create-style.md 的验证规则也确认了这一点——Review Focus 携带恰好一个标记且不能激活视觉复盘阶段。

八项检查清单：

1. 文档对不在场读者独立成立；
2. 时间戳在出现的任何地方携带一致的精度与声明的时区；
3. 检测、升级、缓解与恢复点同时在时间线与任何对齐的图表上可见；
4. 已观测事实、推断与未确认假设全程可区分；
5. 叙述描述响应者在各时刻所知，而非事后诸葛式的显而易见；结果归因于系统与条件而非具名个体；
6. 严重程度颜色匹配其声明的映射，并在灰度下与其标签保持可读；
7. 日志摘录、标识符与图表坐标轴可读且未截断；
8. 每个纠正性行动显示负责人、日期、验证方法及其针对的因素。

九、契约边界与工具链：这份规范如何被创建与校验

9.1 design_spec.md 的必填与禁止项

styles/README.md 明确了design_spec.md的完整契约：必需的正文部分是 I Style Overview（名称、最佳契合、意图、出处）、II Communication Method、III Page Role Vocabulary、IV Evidence & Data Expression、V Visual System Defaults、VI Image & Icon Direction、VII Review Focus。

同时有一长串禁止项——身份、结构或应用所有权：不允许primary_color、色彩出处、Logo、语气语调、图标风格、画布字段、页数/类型、replication_mode、native_structure_mode或占位字段；不允许 Template Overview、Signature Design Elements、Page Roster、SVG 文件名、Master/Layout 身份、槽位几何、固定序列或应用受众/结果规则；不允许当前项目受众、目标、结果、核心消息、交付上下文、afterlife、大纲、页面分配、图标清单或图像列表。

对照incident-postmortem规范全文可以验证：它精确地停在方法层——给出了论证流程、页面角色词汇表与设计默认值，但没有一处涉及具体页面的槽位、几何或当前项目的沟通目标。

9.2 创建与注册流程

这份规范作为库级 Style 工作区，经历了 create-template.md 的完整流程。关键节点包括：

• 输入解释（Step 1）：从参考材料提取论证流程、消息/证据纪律、开放页面角色词汇表、数据表达规则、构图/密度节奏、视觉默认值与图像/图标方向，同时丢弃来源特定的受众、目标、页面顺序/数量、映射、画布与结构；
• 事实简报提案与用户确认门（Step 2–3）：Style 的确认条件是方法、词汇表、证据规则、默认值、方向与复盘焦点均已确认，身份/结构标记为 N/A；在发出[TEMPLATE_BRIEF_CONFIRMED]前不写入任何最终文件；
• 物化（Step 3）：只写templates/design_spec.md，不创建或采用任何图像、图标、SVG、载荷或导出——引用保持为文本出处；
• 校验（Step 5）：运行svg_quality_checker.py "<template_workspace>/templates" --template-mode --canonical-authoring校验 roster-free 契约；库级范围追加register_template.py <style_id> --kind style --dry-run；
• 注册（Step 7）：库级范围运行register_template.py <style_id> --kind style，从规范 frontmatter 派生条目并更新 styles_index.json；
• 输出确认（Step 8）：Style 只列出其规范，声明SVG roster: N/A、Native structure: N/A，并附加Visual review trigger: N/A (advisory focus only)。

Brand 与 Style 均不生成评审 PPTX——Step 6 的模板评审仅对 Layout/Deck 触发，这与"Style 无页面载荷"的定位一致。

9.3 与其他模板种类的轴分离

styles/README.md 强调了一个关键区分：kind: style（可移植的方法与非绑定默认值）、最终的 Stage-2mode（deck 已确认的叙事骨架）、最终的 Stage-2visual_style（deck 已确认的构图与质感锁）以及内部template_reuse_scope: style（不复用结构的扁平导出计划）是四个不同的契约。Style-only 与 Style + Brand 产生扁平计划；Style 与 Layout/Deck 并置时可能使用结构化复用——kind: style在另一个工作区提供结构时绝不强制复用范围。这解释了为何 incident-postmortem 只贡献方法与默认值，而把页面结构交给 Layout/Deck 类工作区。

十、小结：从规范到一次真正的复盘

把整份规范串起来看，incident-postmortem提供的是一个完整的、可独立执行的复盘方法论闭环：

1. 以 briefing 模式组织——中性、完整、可扫描，不推销论点；
2. 按论证流推进——事实 → 解读 → 行动，深度跟随严重程度；
3. 用 11 个页面角色覆盖复盘全谱——从一次阅读即掌握全貌的概要，到高密度的支持证据；
4. 以证据溯源纪律约束每一处断言——时间线条目溯源到带来源的日志/告警/工单，因素溯源到时间线，行动溯源到因素；
5. 用克制的瑞士极简视觉承载可信度——近零装饰、中性底色、状态色配标签、等宽字体承载时间戳与日志；
6. 图像与图标只服务证据——监控屏截图原样保留、脱敏必标记、图标仅标记状态；
7. 以八项 Review Focus 检查收尾——且仅在用户显式激活视觉复盘时应用。

这套规范的价值在于它把"无指责复盘"从一句口号转译成了可执行的页面级规则：时间戳带时区与来源、观测与推断永不混排、结果归因于系统而非个人、行动承诺必须带负责人/日期/验证方法。当你在 ppt-master 中创建或选用incident-postmortem风格时，获得的不只是一套配色与版式倾向，而是一整套经过契约约束、工具链校验、可在会后持续追踪的可靠性复盘方法。

延伸阅读

• incident-postmortem 设计规范原文
• Style 工作区契约与 design_spec.md 规范
• 风格注册索引 styles_index.json
• briefing 模式定义 与 模式目录索引
• swiss-minimal 视觉风格参考
• digital-dashboard 图像渲染参考
• Create Style 子工作流 与 Create Template 入口工作流

【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master