stakeholder-update 技能实战:用 knowledge-work-plugins 为不同受众生成高质量干系人更新

原创2026-09-14 12:15:571,975 阅读
文章标签:人工智能AI 技能插件系统提示工程企业应用协同办公

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(已缓解):已通过行动将风险降低到可接受水平。记录已采取的措施。

有效表达风险的五个步骤

  1. 清晰陈述风险:"存在 [某事] 发生的风险,因为 [原因]";
  2. 量化影响:"如果发生,后果是 [影响]";
  3. 说明可能性:"这 [可能/有可能/不太可能],因为 [证据]";
  4. 给出缓解方案:"我们正通过 [行动] 来管理";
  5. 提出请求:"我们需要 [具体帮助] 来进一步降低此风险"。

风险沟通的常见错误

  • 把风险埋进好消息里。当风险重要时,要把它放在最前面;
  • 表述含糊:"可能会有一些延迟"——要说清楚是什么、多久、为什么;
  • 只报风险不给缓解方案。每个风险都应附带一个计划;
  • 等太久。早沟通的风险是规划输入,晚沟通的风险就是救火演练。

决策记录: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 做出承诺,对齐优先级与范围;
  • 格式(五步):
    1. 回顾:上个 Sprint 交付了什么、什么顺延了、什么被砍掉了;
    2. 优先级:这个 Sprint 最重要的事情是什么;
    3. 产能:团队能承接多少(考虑 PTO、on-call、会议);
    4. 承诺:从待办中选出与产能和优先级匹配的项;
    5. 依赖:标记跨团队或外部依赖;
  • 促进要点:带着建议的优先级顺序来,不要让团队从零开始排序;对过度承诺说不——少承诺、可靠交付更好;确保每项都有明确负责人与明确验收标准;标记范围不清或隐含复杂度的项。

Sprint 规划产出的产能表、风险表与 Definition of Done 可以直接沉淀进工程团队更新的 "In progress / Blockers" 小节(参见 sprint-planning 中的计划到 70-80% 产能、留出缓冲等经验)。

回顾会(Retrospective)

  • 目的:反思什么做得好、什么做得不好、要改变什么;
  • 格式(五步):
    1. 定场:提醒团队目标,营造心理安全感;
    2. 收集数据:什么顺利、什么不顺利、什么令人困惑;
    3. 生成洞察:识别模式与根本原因;
    4. 决定行动:挑选 1-3 个下个 Sprint 要尝试的具体改进;
    5. 收尾:感谢大家的坦诚反馈;
  • 促进要点:营造心理安全感,让大家敢说真话;聚焦系统与流程而非个人;行动项控制在 1-3 个,多了等于没有;跟进上期回顾的行动项——从不跟进,大家就会停止参与;偶尔变换回顾形式,防止僵化。

干系人评审 / Demo

  • 目的:展示进展、收集反馈、建立对齐;
  • 格式(五步):
    1. 上下文:提醒干系人目标以及上次他们看到了什么;
    2. Demo:展示实际构建的东西,用真实产品而不是幻灯片;
    3. 指标:分享任何早期数据或反馈;
    4. 反馈:为提问与输入留出结构化时间;
    5. 下一步:接下来做什么、下次评审何时进行;
  • 促进要点:尽可能演示真实产品,幻灯片不是 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 按你的团队真实工作方式输出。未连接工具时技能会退回为手动收集信息的模式,功能依旧完整可用——这正是该技能"独立可运行、连接工具则更强"的设计原则。

登录后查看全文
knowledge-work-plugins