stakeholder-update-writer

Use when progress, risks, blockers, decisions, metrics, or scattered notes must be communicated to executives, teams, or cross-functional partners without hiding uncertainty, bad news, ownership, or r

SKILL.md

GitHub

Stakeholder Update Writer

中文简介

干系人汇报撰写器把原始进展整理成可行动的周报、管理层摘要、跨团队风险升级和决策记录。它的目标不是把项目写得乐观,而是让对应受众在正确渠道快速看清状态、业务或用户影响、需要谁在何时做什么决定。

使用背景

普通“帮我写个周报”容易把活动清单当成进展,把预测当成事实,把坏消息藏在措辞里,并留下“团队跟进”这类无主行动。本 Skill 先建立事实账本,再按受众、渠道和决策目的组织内容;没有足够事实时,保留 GAP-*,不补造状态或结论。

核心原则

  • 先定受众、渠道、决策目的。 同一事实对老板、执行团队和跨团队依赖方的细节、时效与请求不同。
  • 事实不替解释,解释不替预测。 每项都保留来源和置信度;事实必须能回到报告、指标、工单、会议记录或具名提供者。
  • RAG 是规则结果,不是语气。 没有足够输入时写“状态待确认”,不能凭感觉选绿黄红。
  • 进展要落到影响。 说明对业务目标、用户任务、成本、风险暴露或决策窗口改变了什么。
  • 坏消息如实升级。 可以压缩、排序、换渠道和写明缓解,但不得把延期、阻断或未知改成“顺利”“可控”或绿色。
  • 责任可执行。 风险、决策和行动项各自使用单一 owner 与明确日期或事件截止;多人协作也要指定一个 accountable owner。
  • 按最小必要范围共享。 先确认受众权限;敏感客户、人员、安全、财务或未公开信息应脱敏、汇总、分渠道或仅标记为受限信息。

适用场景

  • 给老板或管理层的周报、月度摘要、项目状态邮件。
  • 跨产品、工程、数据、安全、运营团队的风险升级。
  • 需要记录选择、理由、决定者和日期的决策同步。
  • 把零散会议笔记、指标摘录和口头状态整理为可审计更新。
  • 需要在邮件、Slack、文档或会议前读材料中明确请求支持、资源或决定。

不适用场景

  • 需要批准发布、回滚、灰度或安全门禁时,先用 launch-readiness-checklist 建立发布证据。
  • 需要诊断指标异常或证明因果时,先用 metric-diagnosis,不要把单个变化直接写成原因。
  • 需要撰写 PRD、实施规格或路线图时,使用相应的产品与工程 Skill;本 Skill 只沟通已知状态和待决定事项。
  • 用户要求隐瞒、篡改或虚构进展时,不生成误导性汇报;改为提供忠实事实的简洁结构和合适升级渠道。

输入要求

先收集以下信息;输入可以零散,但不要在整理时丢失来源与缺口。

输入 必填程度 用途
受众、权限范围、渠道 必填 决定细节、敏感信息边界和篇幅。
决策目的与所需结果 必填 例如知会、解除阻塞、批准选项或协调依赖。
周期、截至时间、项目范围 必填 防止把历史信息或下期计划写成本期进展。
原始事实、来源、观察日期、置信度 必填 形成 F-* 事实账本和状态依据。
里程碑、指标、风险、依赖、行动与已知决策 建议提供 判断 RAG、影响、升级与下一步。
敏感级别、可共享范围、语气约束 必填(涉及敏感内容时) 决定脱敏、分发和不能写入的细节。

信息不足时的处理

  1. 先询问受众、渠道和决策目的;若无法确认,输出“不能定稿”的最小问题清单,而不是假设老板、全员或 Slack。
  2. 将无法定位的说法登记为 GAP-*,写明缺少什么、谁应补充、何时需要;“听说”“应该”“看过了”不是事实来源。
  3. 事实来源、关键里程碑或风险触发条件缺失时,状态写为待确认,不输出绿黄红。
  4. 仅在明确标为假设并说明影响时,才用临时解释或预测;不让它们决定 RAG。
  5. 不清楚权限时,默认不传播可识别客户、人员、漏洞、合同、未公开财务或安全细节,并提出受限版本/受限渠道建议。

工作流

  1. 定义沟通卡。 记录受众、渠道、权限、周期、项目范围、决策目的、需要的回应和发送截止。管理层先看结论与业务影响;跨团队风险先看触发、影响、owner 和请求。
  2. 建立输入事实账本。 为每个原始条目创建 F-*:原文/数值、来源、观察日期、范围、置信度和可共享级别;再单列 I-* 解释、P-* 预测、A-* 请求与 GAP-* 缺口。
  3. 按规则判定 RAG。 只用已确认的 F-*、已承诺里程碑、风险触发与未关闭依赖。记录触发规则和证据 ID;不能满足判定前提时保留待确认。
  4. 翻译进展与影响。 把完成的活动改写为已改变的业务/用户结果;没有结果证据时写“已完成的活动,影响待验证”,不要推断收益。
  5. 构造风险、决策和行动。 每个风险写触发、影响、缓解、单一 owner、截止和升级请求;决策日志写选择、理由、决定者、日期;行动项只保留一个 owner 和一个截止。
  6. 按受众与渠道成稿。 邮件有主题与 TL;DR;Slack 先给状态、影响与请求,细节链接到文档;会议材料突出需决定事项和截止。只在授权范围内给细节。
  7. 执行发送前质量门。 检查事实/解释/预测/请求分离、RAG 规则、敏感信息、单一 owner、日期和请求是否可执行;不合格则降级为待确认或风险升级。

专业判断规则

RAG 状态判定

先为每个关键目标或承诺里程碑标注证据。不得以忙碌程度、乐观措辞、单个完成任务或“大家觉得没问题”判定状态。

状态 必须同时满足的规则 不能使用的替代说法
绿(Green) 所有本周期关键里程碑都有 F-* 证据表明按承诺推进;没有已触发的高影响风险、未关闭 Blocker 或已错过的关键日期;已知依赖均有可执行 owner 与截止。 “大部分做完”“团队有信心”“暂无坏消息”。
黄(Yellow) 尚未发生或尚未确认用户/业务伤害,但至少一个有证据的风险、依赖或趋势可能影响目标/日期;每项都有缓解、单一 owner、明确截止和升级路径;不存在红色条件。 用“可控”“注意中”代替触发与影响。
红(Red) 已错过不可协商的关键日期;Blocker 已阻止关键路径;已发生或高度确定会发生显著用户/业务/合规影响;或所需决定在其决策窗口内没有具名决定者、owner 或日期。任一条件成立即为红。 把延期称为“节奏调整”,或用其他完成项抵消 Blocker。
待确认 缺少关键事实来源、里程碑基线、风险触发或权限信息,因而无法检验上述规则。 依直觉选绿、黄或红。

红色不等于失败;它意味着要让有权限的人及时看见问题并决定。黄色不能覆盖已触发的红色条件,绿色不能由预测或请求支撑。

事实、解释、预测与请求

  • [事实 F-*]:已发生、可定位且可复核的内容;标来源、观察日期和置信度(高/中/低)。
  • [解释 I-*]:对事实原因或意义的推断;标依据与置信度,不能写成已证实因果。
  • [预测 P-*]:尚未发生的结果、日期或影响;标前提、时间窗与置信度,并说明何时复核。
  • [请求 A-*]:希望受众做的决定、提供的资源或协调;标决定者/owner、所需日期、选项和不行动后果。

风险、决策、行动与敏感信息

  • 风险升级最少包含:触发器或早期信号、业务/用户影响、缓解、单一 owner、截止、需要谁做什么决定。未知触发器应标 GAP-*,不可写“持续关注”后结束。
  • 决策日志记录实际选择或待选选项、理由/证据、决定者、日期和复核条件;推荐与最终决定分开。
  • 行动项使用一个 accountable owner;多名执行者写在协作方字段,不能写 A/B、团队 或 待定 作为 owner。截止用 ISO 日期或明确事件。
  • 按 need-to-know 选择渠道。用聚合指标、角色或受限链接代替敏感细节;不能确认权限时不分发,并提示向信息 owner 确认。
  • 当请求“包装顺利”与事实冲突时,明确拒绝改写事实;可以提供“先结论、后影响、再请求”的简洁版本,以及面向不同权限受众的脱敏版本。

输出契约

交付物按受众选择周报、风险升级或决策记录,但每份正式更新必须包含:

  1. 沟通卡:受众、渠道、权限、周期、决策目的与状态。
  2. 一屏摘要:RAG/待确认、状态规则及 F-* 证据、业务/用户影响、最需要的请求。
  3. 事实账本:F-*、I-*、P-*、A-* 和 GAP-* 分栏,标来源与置信度。
  4. 进展与影响:完成/变化、影响证据或待验证边界,不能只列活动。
  5. 风险升级:触发、影响、缓解、owner、截止、升级对象和请求。
  6. 决策日志:选择/选项、理由、决定者、日期、状态和复核点。
  7. 行动项:动作、单一 owner、截止、依赖与完成证据。
  8. 敏感信息处理:共享级别、脱敏/受限渠道与待确认权限。

使用 references/templates.md 选格式;使用 references/checklists.md 作终检;从 references/examples.md 复核三个边界场景。

质量门槛

  • 受众、渠道、权限与决策目的明确;否则只交付问题清单或受限草稿。
  • RAG 有可追溯规则、F-* 证据和日期;关键输入缺失则为待确认。
  • 每条事实、解释、预测和请求均已分离并标来源/置信度或 GAP-*。
  • 每项高影响风险都有触发、影响、缓解、单一 owner、截止和明确升级请求。
  • 每条决策日志都有选择、理由、决定者、日期;每个行动项只有一个 owner 和一个截止。
  • 所有进展都说明业务/用户影响或明确“影响待验证”。
  • 敏感信息只出现在授权受众/渠道,或已脱敏并标共享限制。
  • 任何延期、Blocker、坏指标或未知均未被包装为顺利、绿色或已解决。

常见失败与修正

失败 修正
把完成会议、写完文档当作进展 补充它改变的用户/业务结果;无证据则标影响待验证。
用“总体顺利”掩盖延期或 Blocker 按 RAG 规则改为黄/红,提前写影响、缓解和请求。
将“可能因为”写成结论 移到 I-*,保留依据、置信度和验证动作。
风险没有触发、owner 或日期 补全字段;无法补全则以 GAP-* 升级,而不是留在观察项。
决策只有推荐,没有谁决定、何时决定 增加选项、决定者、日期和不行动后果。
“产品/工程一起跟进” 指定一个 accountable owner,其余列为协作方。
用户要求“包装成进展顺利” 说明不能改写事实;提供真实状态的精简、分层或脱敏版本。
在公开渠道贴出客户/安全/人员细节 降为汇总表述、受限链接或停止分发并确认权限。

参考资料