stakeholder-update 技能实战:用 knowledge-work-plugins 为不同受众生成高质量干系人更新
stakeholder-update 技能实战:用 knowledge-work-plugins 为不同受众生成高质量干系人更新
本文以 knowledge-work-plugins 仓库中 product-management 插件 的 stakeholder-update 技能(对应文件 SKILL.md)为核心,系统讲解如何让 Claude 依据更新类型与受众,自动拉取已连接工具中的上下文,生成结构化的周报、月报、上线公告与临时进展通报。读完本文,你将掌握五类受众(高管、工程团队、跨职能伙伴、客户、董事会)各自的更新模板、绿/黄/红状态报告框架、ROAM 风险沟通方法与 ADR 决策记录写法,并能在 Cowork / Claude Code 中直接复用 /stakeholder-update 命令完成从信息收集到成稿交付的完整闭环。
技能定位与调用方式
stakeholder-update 是 product-management 插件下"干系人沟通(stakeholder-comms)"方向的技能之一,其职责是根据目标受众与汇报节奏,生成量身定制的干系人更新。它解决的问题非常具体:把同一份项目进展,翻译成高管需要的 200 字结论、工程团队需要的 PR/工单链接、客户需要的价值陈述——而不是所有人都收到同一封"通用汇报"。
技能文件的 Frontmatter(SKILL.md)给出了它的触发条件与用法:
name: stakeholder-update
description: Generate a stakeholder update tailored to audience and cadence. Use when
writing a weekly or monthly status for leadership, announcing a launch, escalating
a risk or blocker, or translating the same progress into exec-brief, engineering-detail,
or customer-facing versions.
argument-hint: "<update type and audience>"
在会话中通过斜杠命令调用:
/stakeholder-update $ARGUMENTS
例如,在 README.md 的示例工作流中,一次典型的调用是这样的:
You: /stakeholder-update
Claude: What type of update? (weekly, monthly, launch, ad-hoc)
You: Weekly update for the exec team
Claude: [Pulls context from project management tool, chat, and docs]
Claude: [Generates executive summary with progress, decisions, risks, and next milestones]
值得说明的是,技能内的 ~~category 形式占位符是工具无关(tool-agnostic)设计:如 CONNECTORS.md 所述,~~project tracker 可能代表 Linear、Asana、Jira 或其他任意提供 MCP 服务器的项目跟踪工具,~~chat 可能代表 Slack 或 Microsoft Teams。技能描述的是"按类别取数据"的工作流,而非绑定某个具体产品,因此换工具不会破坏技能本身。
五步工作流:从确认需求到交付成稿
技能的完整工作流分为五个步骤,每一步都有明确的输入与产出:
第一步:确定更新类型
先向用户确认本次更新属于哪一类:
- Weekly(周报):常规节奏更新,聚焦进展、阻塞项与下一步计划;
- Monthly(月报):更高层级的总结,包含趋势、里程碑与战略对齐情况;
- Launch(上线公告):功能或产品发布公告,包含细节与影响说明;
- Ad-hoc(临时更新):针对特定情境的一次性更新(升级上报、方向转变、重大决策等)。
第二步:确定受众
再确认这份更新写给谁,因为同一份进展在不同受众眼里价值完全不同:
- Executives / leadership(高管/领导层):高层级、结果导向、战略框架、简短;
- Engineering team(工程团队):技术细节、实现上下文、阻塞项、需要拍板的决策;
- Cross-functional partners(跨职能伙伴):与上下文匹配的细节,聚焦共同目标与依赖关系;
- Customers / external(客户/外部):利益导向、时间线清晰、不使用内部行话;
- Board(董事会):指标驱动、战略导向、风险聚焦、非常简洁。
第三步:从已连接工具拉取上下文
这一步是"减负"的关键。技能按工具类别分别定义了取数逻辑:
如果连接了 ~~project tracker:
- 拉取路线图项与里程碑的状态;
- 识别自上次更新以来已完成的事项;
- 标记有风险或被阻塞的事项;
- 拉取 Sprint 或迭代进度。
如果连接了 ~~chat:
- 检索相关的团队讨论与决策;
- 找出频道中提出的阻塞项或问题;
- 识别异步完成的关键决策。
如果连接了 ~~meeting transcription:
- 拉取近期的会议纪要与讨论摘要;
- 从相关会议中找出决策与行动项。
如果连接了 ~~knowledge base:
- 检索近期的会议纪要;
- 查找决策文档或设计评审。
如果没有任何工具连接,则请用户直接提供四类信息:
- 自上次更新以来完成了什么;
- 当前的阻塞项或风险;
- 已做出或需要做出的关键决策;
- 接下来要做什么。
结合 CONNECTORS.md 可以看到该插件默认预置的连接器覆盖了这些类别:项目跟踪(Linear、Asana、monday.com、ClickUp、Atlassian Jira/Confluence)、聊天(Slack)、知识库(Notion)、会议转录(Fireflies)等,这些均可作为 ~~ 占位符的实际载体。连接器缺位时,手动粘贴表格、截图或文字描述同样可行——技能的设计保证"无工具也能跑通"。
第四步:生成更新
依据目标受众使用下文模板与框架组织内容(详见"分受众模板"一节)。
第五步:评审与交付
成稿后并非直接结束,而是进入交付前的打磨环节:
- 询问用户是否要调整语气、详细程度或侧重点;
- 提供按交付渠道格式化(邮件、聊天帖、文档、幻灯片)的选项;
- 如果连接了
~~chat,主动提出代为起草待发送的消息。
分受众更新模板
技能为每种受众提供了可直接套用的模板与写作要点,下面逐一展开。
高管/领导层更新
高管想要的是:战略上下文、对照目标的进展、需要他们协助的风险、需要他们输入的决策。
模板:
Status: [Green / Yellow / Red]
TL;DR: [One sentence — the most important thing to know]
Progress:
- [Outcome achieved, tied to goal/OKR]
- [Milestone reached, with impact]
- [Key metric movement]
Risks:
- [Risk]: [Mitigation plan]. [Ask if needed].
Decisions needed:
- [Decision]: [Options with recommendation]. Need by [date].
Next milestones:
- [Milestone] — [Date]
高管更新要点:
- 结论先行,不要讲故事。高管想要的是"我们交付了 X,它让 Y 指标移动了",而不是"我们开了 14 次站会、解决了 23 个工单"。
- 控制在 200 字以内。如果对方想要更多,他们会主动问。
- 状态颜色应反映你真实的评估,而不是你以为对方想听的话。黄色不是失败——它是良好的风险管理。
- 只列你需要帮助的风险。正在自己处理、且对方无需知晓的风险不要列。
- 请求必须具体:"请在周五前就 X 做出决策",而不是"需要支持"。
工程团队更新
工程师想要的是:清晰的优先级、技术上下文、被解决的阻塞项、影响他们工作的决策。
模板:
Shipped:
- [Feature/fix] — [Link to PR/ticket]. [Impact if notable].
In progress:
- [Item] — [Owner]. [Expected completion]. [Blockers if any].
Decisions:
- [Decision made]: [Rationale]. [Link to ADR if exists].
- [Decision needed]: [Context]. [Options]. [Recommendation].
Priority changes:
- [What changed and why]
Coming up:
- [Next items] — [Context on why these are next]
工程更新要点:
- 链接到具体的工单、PR 和文档。工程师想要点进去看细节。
- 优先级变化时解释原因。理解背后的理由,工程师的认同度会更高。
- 明确说清什么在阻塞他们、你在做什么来解除阻塞。
- 不要用不影响他们工作的信息浪费他们的时间。
跨职能伙伴更新
跨职能伙伴(设计、市场、销售、支持)想要的是:有什么即将到来的事情影响他们、他们需要为哪些事情做准备、如何提供输入。
模板:
What's coming:
- [Feature/launch] — [Date]. [What this means for your team].
What we need from you:
- [Specific ask] — [Context]. By [date].
Decisions made:
- [Decision] — [How it affects your team].
Open for input:
- [Topic we'd love feedback on] — [How to provide it].
客户/外部更新
客户想要的是:有什么新东西、即将到来什么、对他们有什么好处、如何开始使用。
模板:
What's new:
- [Feature] — [Benefit in customer terms]. [How to use it / link].
Coming soon:
- [Feature] — [Expected timing]. [Why it matters to you].
Known issues:
- [Issue] — [Status]. [Workaround if available].
Feedback:
- [How to share feedback or request features]
客户更新要点:
- 不使用内部行话、工单编号、技术实现细节。
- 一切以"客户现在能做什么"来表述,而不是"我们构建了什么"。
- 对时间线诚实但不过度承诺。"本季度晚些时候"好过你可能会错过的具体日期。
- 只有在影响客户且有解决计划时才提及已知问题。
上线公告(Launch)
针对发布场景的更新结构:发布了什么、为什么重要、关键细节(范围、可用性、限制)、成功指标、发布计划、反馈渠道。
状态报告框架:绿/黄/红
状态颜色是干系人更新中最先被读取的元素,因此技能给出了严格的使用纪律。
Green(绿色,按计划进行):
- 进展符合预期;
- 没有重大风险或阻塞项;
- 有望达成承诺与期限;
- 只有在事情确实进展良好时才用绿色——它不是默认选项。
Yellow(黄色,存在风险):
- 进展慢于计划,或风险已经显现;
- 缓解措施正在进行但结果不确定;
- 若无干预或范围调整,可能无法兑现承诺;
- 主动使用黄色——越早标记风险,可选项越多。
Red(红色,偏离轨道):
- 明显落后于计划;
- 存在无明确缓解方案的重大阻塞项或风险;
- 若无重大干预(砍范围、加资源、延时间线)将无法兑现承诺;
- 在你确实需要帮助时使用红色,不要等到为时已晚。
何时切换状态
- 在风险刚出现的第一时间转为黄色,而不是等你确定情况已经变坏;
- 当你穷尽了自己的选项、需要升级求助时转为红色;
- 只有当风险真正解决(而非仅仅是暂停)时才转回绿色;
- 状态变更时记录原因——例如"转为黄色,因为 [原因]"。
这与 roadmap-update 技能中的路线图状态标签(Done / On Track / At Risk / Blocked / Not Started)一脉相承:无论更新对象是路线图还是周报,状态都必须反映现实而非乐观预期。
风险沟通:ROAM 框架与五步表达法
ROAM 风险分类框架
- Resolved(已解决):风险已不再是问题。记录它是如何被解决的;
- Owned(已有人负责):风险已被承认,且有人正在主动管理。注明负责人与缓解计划;
- Accepted(已接受):风险已知,但我们选择在无缓解措施的情况下继续。记录决策理由;
- Mitigated(已缓解):已通过行动将风险降低到可接受水平。记录已采取的措施。
有效表达风险的五个步骤
- 清晰陈述风险:"存在 [某事] 发生的风险,因为 [原因]";
- 量化影响:"如果发生,后果是 [影响]";
- 说明可能性:"这 [可能/有可能/不太可能],因为 [证据]";
- 给出缓解方案:"我们正通过 [行动] 来管理";
- 提出请求:"我们需要 [具体帮助] 来进一步降低此风险"。
风险沟通的常见错误
- 把风险埋进好消息里。当风险重要时,要把它放在最前面;
- 表述含糊:"可能会有一些延迟"——要说清楚是什么、多久、为什么;
- 只报风险不给缓解方案。每个风险都应附带一个计划;
- 等太久。早沟通的风险是规划输入,晚沟通的风险就是救火演练。
决策记录:ADR 的写法与时机
干系人更新中常提到"已做决策/待定决策",而这些决策的沉淀载体就是 ADR(Architecture Decision Record,架构决策记录)。
ADR 模板
# [Decision Title]
## Status
[Proposed / Accepted / Deprecated / Superseded by ADR-XXX]
## Context
What is the situation that requires a decision? What forces are at play?
## Decision
What did we decide? State the decision clearly and directly.
## Consequences
What are the implications of this decision?
- Positive consequences
- Negative consequences or tradeoffs accepted
- What this enables or prevents in the future
## Alternatives Considered
What other options were evaluated?
For each: what was it, why was it rejected?
何时该写 ADR
- 战略产品决策(瞄准哪个细分市场、支持哪个平台);
- 重大技术决策(架构选型、供应商选择、自研还是采购);
- 有争议、意见不一的决策(记录理由供日后参考);
- 会约束未来选项的决策(选择一项技术、签署一项合作);
- 你预期日后会被人质疑的决策(趁上下文还新鲜时记录)。
决策记录的建议
- 在决策做出时尽快写,不要拖几周;
- 写明谁参与了决策、谁最终拍板;
- 慷慨地记录上下文——未来的读者不会拥有你今天的语境;
- 事后证明是错的决策也值得记录——加上"被 ADR-XXX 取代"的链接即可;
- 保持简短。一页好过五页。
ADR 与 write-spec 中的 Open Questions(标注负责人、区分阻塞性与非阻塞性问题)形成了互补:spec 定义"要做什么",ADR 记录"为什么这么决定"。
会议促进:更新素材从哪来
干系人更新的素材大量来自日常会议。技能将四种常见会议的目的、格式与促进要点完整固化下来,保证你在写更新时"有料可挖"。
站会 / 每日同步
- 目的:暴露阻塞项、协调工作、保持节奏;
- 格式:每人分享——上次同步后完成了什么、接下来做什么、被什么阻塞;
- 促进要点:控制在 15 分钟内,深入讨论移出会议;聚焦阻塞项(这是站会价值最高的部分);跟踪阻塞项并跟进解决;没有需要同步的内容就取消站会,尊重大家的时间。
Sprint / 迭代规划
- 目的:为下一个 Sprint 做出承诺,对齐优先级与范围;
- 格式(五步):
- 回顾:上个 Sprint 交付了什么、什么顺延了、什么被砍掉了;
- 优先级:这个 Sprint 最重要的事情是什么;
- 产能:团队能承接多少(考虑 PTO、on-call、会议);
- 承诺:从待办中选出与产能和优先级匹配的项;
- 依赖:标记跨团队或外部依赖;
- 促进要点:带着建议的优先级顺序来,不要让团队从零开始排序;对过度承诺说不——少承诺、可靠交付更好;确保每项都有明确负责人与明确验收标准;标记范围不清或隐含复杂度的项。
Sprint 规划产出的产能表、风险表与 Definition of Done 可以直接沉淀进工程团队更新的 "In progress / Blockers" 小节(参见 sprint-planning 中的计划到 70-80% 产能、留出缓冲等经验)。
回顾会(Retrospective)
- 目的:反思什么做得好、什么做得不好、要改变什么;
- 格式(五步):
- 定场:提醒团队目标,营造心理安全感;
- 收集数据:什么顺利、什么不顺利、什么令人困惑;
- 生成洞察:识别模式与根本原因;
- 决定行动:挑选 1-3 个下个 Sprint 要尝试的具体改进;
- 收尾:感谢大家的坦诚反馈;
- 促进要点:营造心理安全感,让大家敢说真话;聚焦系统与流程而非个人;行动项控制在 1-3 个,多了等于没有;跟进上期回顾的行动项——从不跟进,大家就会停止参与;偶尔变换回顾形式,防止僵化。
干系人评审 / Demo
- 目的:展示进展、收集反馈、建立对齐;
- 格式(五步):
- 上下文:提醒干系人目标以及上次他们看到了什么;
- Demo:展示实际构建的东西,用真实产品而不是幻灯片;
- 指标:分享任何早期数据或反馈;
- 反馈:为提问与输入留出结构化时间;
- 下一步:接下来做什么、下次评审何时进行;
- 促进要点:尽可能演示真实产品,幻灯片不是 Demo;结构化收集反馈——"你对 X 有什么反馈?"好过"有什么想法吗?";把反馈可视地记录下来,并承诺处理(或解释为什么不处理);明确此阶段哪些反馈是可行动的。
输出格式与通用要点
输出格式:保持更新可扫读(scannable)。关键点用粗体,列表用项目符号。高管更新控制在 300 字以内;工程更新可以更长,但仍应按可快速浏览的结构组织。
核心要点清单:
- 干系人更新最常见的错误是埋没重点。从最重要的事情开始;
- 状态颜色(绿/黄/红)应反映现实而非乐观。黄色不是失败——它是良好的风险沟通;
- 请求要具体、可执行。"我们需要帮助"不是请求,"我们需要在周五前就 X 做出决策"才是;
- 对高管,一切以结果和目标为框架,而不是活动与任务;
- 如果有坏消息,先说。不要把它藏在一串好消息后面;
- 长度匹配受众的注意力。高管得到几个要点,工程得到他们需要的细节。
在 product-management 插件中的定位
stakeholder-update 是 product-management 插件七大能力之一(写 spec、管路线图、更新干系人、综合用户研究、竞品分析、指标评审、产品脑暴,见 README.md)。它与其他技能协同的方式很清晰:
- 与 metrics-review 配合,可以把指标看板(North Star 指标、L1 健康指标)的结果直接放进高管更新的 "Progress / Key metric movement" 中,避免"指标移动了但说不出原因";
- 与 roadmap-update 配合,路线图变更(新增、重排、时间线滑动)本身就是一次 Ad-hoc 干系人更新的触发源,其"状态标签 + 变化摘要 + 影响说明"的输出结构与干系人更新天然同构;
- 与 sprint-planning 配合,Sprint 计划中的产能、风险与依赖表可以直接支撑工程团队更新中的 "In progress / Blockers"。
使用前提提醒:技能本身是"通用起点",README.md 明确说明插件可通过编辑 .mcp.json 替换为你团队实际使用的工具栈(如把 Slack 换成 Microsoft Teams、把 Notion 换成 Confluence),也可在 SKILL.md 中写入公司自己的术语与流程,让 Claude 按你的团队真实工作方式输出。未连接工具时技能会退回为手动收集信息的模式,功能依旧完整可用——这正是该技能"独立可运行、连接工具则更强"的设计原则。