风格规范解析:在 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 部分用一张表格给出了核心属性属性值Style NameIncident PostmortemBest Fit生产事故复盘、宕机报告、质量与安全检查、安全事件简报、可靠性回顾Reusable Intent让组织从一次失败中学习——发生了什么、是什么让它发生、将做出什么改变——而不让叙述偏向任何人为自己辩护Sources2026-08-07 在仓库内作为捆绑参考 Style 撰写源自 blameless-postmortem 实践经验的提炼而非单一外部文档两个要点值得展开。其一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.mdmode 是 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这是规范中分量最重的部分六条规则环环相扣始终区分已观测事件、推断序列、促成因素与假设任何未确认内容必须标注未确认描述各时刻人们所知所见而非事后诸葛式的显而易见将结果归因于条件与系统而非个体——点名角色与系统不点名有过失的人报告实际影响而非最能保护团队的估计底层条件未消除时不得将因素标记为已解决事实与解读分离承诺的行动必须可验证。四、Page Role Vocabulary页面角色词汇表规范第 III 部分定义了 11 个页面角色每个角色都绑定三项内容沟通任务Communication Job、证据义务Evidence Obligation、构图倾向Composition Tendency。完整表格如下角色沟通任务证据义务构图倾向Incident summary一次阅读给出整个事件用与其他任何地方一致的数字陈述严重程度、时长、范围与影响一页即可概览它会被单独引用和转发Impact assessment确立实际代价量化受影响用户、事务、数据、收入或安全暴露并给出测量依据让测量到的影响占主导陈述不确定性而非四舍五入到舒适值Timeline按顺序重建发生了什么为检测、升级、缓解与恢复给出带时区与来源的时间戳让时间顺序驱动构图保持检测与缓解间隙可见Detection and alerting展示如何以及何时为人所知说明什么告警了、什么没有以及花了多久才到达能行动的人让检测延迟清晰可读而非折进时间线Response and mitigation展示做了什么以及什么有效区分有帮助、无效果或使情况恶化的行动依据当时可获取的信息保持决策点可见并标明每个决策点当时已知什么Contributing factors解释是什么允许故障发生给出多重因素——技术、流程与组织层面的——而不坍缩为单一原因展示因素如何组合当现实是分层的抵制单框根因图Systemic condition识别什么让复发成为可能将事件与事件之后持续存在的条件相连包括先前的类似事件让条件优先于恰好触发的特定诱因What went well保护应被保留之物点名限制损害的控件、实践与决策给它真实的空间只列失败的复盘教会错误的教训Corrective action承诺可验证的改变给出负责人、日期、验证方法及其针对的因素区分预防、检测与缓解保持行动、负责人与验证直接对应Open question保留仍未可知之物陈述未能确定的内容以及何种证据可以定案让未知保持可见而非用貌似合理的叙述去消解Supporting evidence承载复盘所依赖的材料保留带时间戳与来源的日志、图表、配置与追踪高密度按验证目的组织而非按阅读顺序值得注意两点。第一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 部分末尾给出完整的回退色板它属于优先级更低的默认值绝不等于身份角色HEX用途Field#FFFFFF事实记录的中性地面Surface#F2F4F6分组区域、时间线带状、证据块Ink#1F2933主要文本、时间戳与规则线Normal#4A5568事件前基线与未受影响状态Degraded#B7791F部分影响、升级风险或检测间隙Critical#B4342C完全影响窗口与突破阈值Recovered#2E7D5B缓解生效且服务恢复这套色板的设计语义非常明确七种颜色中五种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 携带恰好一个标记且不能激活视觉复盘阶段。八项检查清单文档对不在场读者独立成立时间戳在出现的任何地方携带一致的精度与声明的时区检测、升级、缓解与恢复点同时在时间线与任何对齐的图表上可见已观测事实、推断与未确认假设全程可区分叙述描述响应者在各时刻所知而非事后诸葛式的显而易见结果归因于系统与条件而非具名个体严重程度颜色匹配其声明的映射并在灰度下与其标签保持可读日志摘录、标识符与图表坐标轴可读且未截断每个纠正性行动显示负责人、日期、验证方法及其针对的因素。九、契约边界与工具链这份规范如何被创建与校验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–3Style 的确认条件是方法、词汇表、证据规则、默认值、方向与复盘焦点均已确认身份/结构标记为 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 8Style 只列出其规范声明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-2modedeck 已确认的叙事骨架、最终的 Stage-2visual_styledeck 已确认的构图与质感锁以及内部template_reuse_scope: style不复用结构的扁平导出计划是四个不同的契约。Style-only 与 Style Brand 产生扁平计划Style 与 Layout/Deck 并置时可能使用结构化复用——kind: style在另一个工作区提供结构时绝不强制复用范围。这解释了为何 incident-postmortem 只贡献方法与默认值而把页面结构交给 Layout/Deck 类工作区。十、小结从规范到一次真正的复盘把整份规范串起来看incident-postmortem提供的是一个完整的、可独立执行的复盘方法论闭环以 briefing 模式组织——中性、完整、可扫描不推销论点按论证流推进——事实 → 解读 → 行动深度跟随严重程度用 11 个页面角色覆盖复盘全谱——从一次阅读即掌握全貌的概要到高密度的支持证据以证据溯源纪律约束每一处断言——时间线条目溯源到带来源的日志/告警/工单因素溯源到时间线行动溯源到因素用克制的瑞士极简视觉承载可信度——近零装饰、中性底色、状态色配标签、等宽字体承载时间戳与日志图像与图标只服务证据——监控屏截图原样保留、脱敏必标记、图标仅标记状态以八项 Review Focus 检查收尾——且仅在用户显式激活视觉复盘时应用。这套规范的价值在于它把无指责复盘从一句口号转译成了可执行的页面级规则时间戳带时区与来源、观测与推断永不混排、结果归因于系统而非个人、行动承诺必须带负责人/日期/验证方法。当你在 ppt-master 中创建或选用incident-postmortem风格时获得的不只是一套配色与版式倾向而是一整套经过契约约束、工具链校验、可在会后持续追踪的可靠性复盘方法。延伸阅读incident-postmortem 设计规范原文Style 工作区契约与 design_spec.md 规范风格注册索引 styles_index.jsonbriefing 模式定义 与 模式目录索引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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考