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
Files6
View on GitHubSKILL.mdstakeholder-update-writer/SKILL.md
GitHubStakeholder Update Writer
中文简介
干系人汇报撰写器把原始进展整理成可行动的周报、管理层摘要、跨团队风险升级和决策记录。它的目标不是把项目写得乐观,而是让对应受众在正确渠道快速看清状态、业务或用户影响、需要谁在何时做什么决定。
使用背景
普通“帮我写个周报”容易把活动清单当成进展,把预测当成事实,把坏消息藏在措辞里,并留下“团队跟进”这类无主行动。本 Skill 先建立事实账本,再按受众、渠道和决策目的组织内容;没有足够事实时,保留 GAP-*,不补造状态或结论。
核心原则
- 先定受众、渠道、决策目的。 同一事实对老板、执行团队和跨团队依赖方的细节、时效与请求不同。
- 事实不替解释,解释不替预测。 每项都保留来源和置信度;事实必须能回到报告、指标、工单、会议记录或具名提供者。
- RAG 是规则结果,不是语气。 没有足够输入时写“状态待确认”,不能凭感觉选绿黄红。
- 进展要落到影响。 说明对业务目标、用户任务、成本、风险暴露或决策窗口改变了什么。
- 坏消息如实升级。 可以压缩、排序、换渠道和写明缓解,但不得把延期、阻断或未知改成“顺利”“可控”或绿色。
- 责任可执行。 风险、决策和行动项各自使用单一 owner 与明确日期或事件截止;多人协作也要指定一个 accountable owner。
- 按最小必要范围共享。 先确认受众权限;敏感客户、人员、安全、财务或未公开信息应脱敏、汇总、分渠道或仅标记为受限信息。
适用场景
- 给老板或管理层的周报、月度摘要、项目状态邮件。
- 跨产品、工程、数据、安全、运营团队的风险升级。
- 需要记录选择、理由、决定者和日期的决策同步。
- 把零散会议笔记、指标摘录和口头状态整理为可审计更新。
- 需要在邮件、Slack、文档或会议前读材料中明确请求支持、资源或决定。
不适用场景
- 需要批准发布、回滚、灰度或安全门禁时,先用
launch-readiness-checklist建立发布证据。 - 需要诊断指标异常或证明因果时,先用
metric-diagnosis,不要把单个变化直接写成原因。 - 需要撰写 PRD、实施规格或路线图时,使用相应的产品与工程 Skill;本 Skill 只沟通已知状态和待决定事项。
- 用户要求隐瞒、篡改或虚构进展时,不生成误导性汇报;改为提供忠实事实的简洁结构和合适升级渠道。
输入要求
先收集以下信息;输入可以零散,但不要在整理时丢失来源与缺口。
| 输入 | 必填程度 | 用途 |
|---|---|---|
| 受众、权限范围、渠道 | 必填 | 决定细节、敏感信息边界和篇幅。 |
| 决策目的与所需结果 | 必填 | 例如知会、解除阻塞、批准选项或协调依赖。 |
| 周期、截至时间、项目范围 | 必填 | 防止把历史信息或下期计划写成本期进展。 |
| 原始事实、来源、观察日期、置信度 | 必填 | 形成 F-* 事实账本和状态依据。 |
| 里程碑、指标、风险、依赖、行动与已知决策 | 建议提供 | 判断 RAG、影响、升级与下一步。 |
| 敏感级别、可共享范围、语气约束 | 必填(涉及敏感内容时) | 决定脱敏、分发和不能写入的细节。 |
信息不足时的处理
- 先询问受众、渠道和决策目的;若无法确认,输出“不能定稿”的最小问题清单,而不是假设老板、全员或 Slack。
- 将无法定位的说法登记为
GAP-*,写明缺少什么、谁应补充、何时需要;“听说”“应该”“看过了”不是事实来源。 - 事实来源、关键里程碑或风险触发条件缺失时,状态写为待确认,不输出绿黄红。
- 仅在明确标为假设并说明影响时,才用临时解释或预测;不让它们决定 RAG。
- 不清楚权限时,默认不传播可识别客户、人员、漏洞、合同、未公开财务或安全细节,并提出受限版本/受限渠道建议。
工作流
- 定义沟通卡。 记录受众、渠道、权限、周期、项目范围、决策目的、需要的回应和发送截止。管理层先看结论与业务影响;跨团队风险先看触发、影响、owner 和请求。
- 建立输入事实账本。 为每个原始条目创建
F-*:原文/数值、来源、观察日期、范围、置信度和可共享级别;再单列I-*解释、P-*预测、A-*请求与GAP-*缺口。 - 按规则判定 RAG。 只用已确认的
F-*、已承诺里程碑、风险触发与未关闭依赖。记录触发规则和证据 ID;不能满足判定前提时保留待确认。 - 翻译进展与影响。 把完成的活动改写为已改变的业务/用户结果;没有结果证据时写“已完成的活动,影响待验证”,不要推断收益。
- 构造风险、决策和行动。 每个风险写触发、影响、缓解、单一 owner、截止和升级请求;决策日志写选择、理由、决定者、日期;行动项只保留一个 owner 和一个截止。
- 按受众与渠道成稿。 邮件有主题与 TL;DR;Slack 先给状态、影响与请求,细节链接到文档;会议材料突出需决定事项和截止。只在授权范围内给细节。
- 执行发送前质量门。 检查事实/解释/预测/请求分离、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 确认。
- 当请求“包装顺利”与事实冲突时,明确拒绝改写事实;可以提供“先结论、后影响、再请求”的简洁版本,以及面向不同权限受众的脱敏版本。
输出契约
交付物按受众选择周报、风险升级或决策记录,但每份正式更新必须包含:
- 沟通卡:受众、渠道、权限、周期、决策目的与状态。
- 一屏摘要:RAG/待确认、状态规则及
F-*证据、业务/用户影响、最需要的请求。 - 事实账本:
F-*、I-*、P-*、A-*和GAP-*分栏,标来源与置信度。 - 进展与影响:完成/变化、影响证据或待验证边界,不能只列活动。
- 风险升级:触发、影响、缓解、owner、截止、升级对象和请求。
- 决策日志:选择/选项、理由、决定者、日期、状态和复核点。
- 行动项:动作、单一 owner、截止、依赖与完成证据。
- 敏感信息处理:共享级别、脱敏/受限渠道与待确认权限。
使用 references/templates.md 选格式;使用 references/checklists.md 作终检;从 references/examples.md 复核三个边界场景。
质量门槛
- 受众、渠道、权限与决策目的明确;否则只交付问题清单或受限草稿。
- RAG 有可追溯规则、
F-*证据和日期;关键输入缺失则为待确认。 - 每条事实、解释、预测和请求均已分离并标来源/置信度或
GAP-*。 - 每项高影响风险都有触发、影响、缓解、单一 owner、截止和明确升级请求。
- 每条决策日志都有选择、理由、决定者、日期;每个行动项只有一个 owner 和一个截止。
- 所有进展都说明业务/用户影响或明确“影响待验证”。
- 敏感信息只出现在授权受众/渠道,或已脱敏并标共享限制。
- 任何延期、Blocker、坏指标或未知均未被包装为顺利、绿色或已解决。
常见失败与修正
| 失败 | 修正 |
|---|---|
| 把完成会议、写完文档当作进展 | 补充它改变的用户/业务结果;无证据则标影响待验证。 |
| 用“总体顺利”掩盖延期或 Blocker | 按 RAG 规则改为黄/红,提前写影响、缓解和请求。 |
| 将“可能因为”写成结论 | 移到 I-*,保留依据、置信度和验证动作。 |
| 风险没有触发、owner 或日期 | 补全字段;无法补全则以 GAP-* 升级,而不是留在观察项。 |
| 决策只有推荐,没有谁决定、何时决定 | 增加选项、决定者、日期和不行动后果。 |
| “产品/工程一起跟进” | 指定一个 accountable owner,其余列为协作方。 |
| 用户要求“包装成进展顺利” | 说明不能改写事实;提供真实状态的精简、分层或脱敏版本。 |
| 在公开渠道贴出客户/安全/人员细节 | 降为汇总表述、受限链接或停止分发并确认权限。 |