基于 Common Room 的 weekly-prep-brief 技能：构建 7 天外部会议周报备战的完整工作流

基于 Common Room 的 weekly-prep-brief 技能：构建 7 天外部会议周报备战的完整工作流

【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins

本指南讲解 knowledge-work-plugins 仓库中 Common Room 插件的weekly-prep-brief技能：如何自动抓取未来 7 天的全部外部客户/潜在客户会议，逐场调用账号研究与联系人研究技能，最终汇总为一份按时间排序、可扫描的单页周报。读完本文，你将掌握该技能的四步处理流程、输出模板、稀疏数据降级策略与边界情况处理规则，并能直接复用到自己的 GTM（Go-To-Market）会议备战工作中。

技能定位：一次触发，覆盖整周外部会议

weekly-prep-brief是 Common Room 插件 的六个技能之一，其目标是把「散落在日历里的外部会议 + Common Room 的信号数据」合成为一份统一的每周简报。技能定义位于 weekly-prep-brief 的 SKILL.md，触发方式为会话式自然语言，例如：

• "weekly prep brief"
• "prepare my week"
• "what calls do I have this week"
• "Monday prep"

技能描述明确其适用场景：生成一份覆盖未来 7 天内每一场外部客户或潜在客户会议的综合性简报，且每一场会议都附带来自 Common Room 的账号与联系人研究。这一定位与插件的整体架构一致——所有输出都锚定在 Common Room 的真实信号数据之上（一方产品信号、二方社区信号、三方意向信号，以及 RoomieAI 与 Spark 的增强数据）。

连接器依赖：Common Room 为必需，日历可选

根据 CONNECTORS.md，插件文件使用~~category占位符代表用户在该类别下连接的任意工具：

• Common Room MCP（mcp.commonroom.io/mcp）是插件所有技能与命令的主数据源，必须连接并完成认证，插件才能工作；
• 日历连接器（可选）：weekly-prep-brief与call-prep两个技能会用它自动获取外部会议；未连接时，两个技能都会优雅降级为手动向用户索取会议信息。

此外，仓库还提供了一个显式命令/weekly-brief [date range]（默认取未来 7 天），其流程定义在 commands/weekly-brief.md，核心逻辑与技能完全一致：先取日历外部会议 → 无日历则询问用户 → 并行执行账号/联系人研究 → 按日期排序汇总成周报。两者共享同一套产物标准——整份简报应在 10 分钟内读完。

四步处理流程：从日历到完整周报

SKILL.md 将整个备战过程拆分为四个明确步骤，每步都有可执行的判定逻辑。

步骤 1：获取本周外部会议

Option A —— 已连接日历：使用~~calendar连接器拉取未来 7 天（或用户指定的时间范围）内排期的所有会议，然后过滤，只保留外部会议——即存在你组织以外参会者的会议；剔除纯内部会议、同事间的一对一以及周期性内部同步会。

对每场保留下来的外部会议，识别并记录三个要素：

• 公司名称（Company name）
• 会议日期与时间（Meeting date and time）
• 外部参会者姓名与邮箱（External attendee names and email addresses）

Option B —— 未连接日历：向用户提问："To build your weekly prep brief, I'll need your upcoming external calls. Please list them: company name, date/time, and attendee names."（为构建你的周报，我需要你接下来要参加的外部会议，请列出：公司名、日期/时间、参会者姓名。）

接受自由格式输入，并在继续前将其解析为结构化列表。

步骤 2：确认会议清单

在开始研究前，将识别出的会议呈现给用户确认，避免把研究资源浪费在已取消或错误的会议上。SKILL.md 给出了标准话术模板：

"Here are the external calls I found for this week. Let me know if anything's missing or should be excluded:

• [Company] — [Day], [Time] — [Attendees]
• ..."

步骤 3：逐场研究每场会议

对每场已确认的外部会议，尽可能并行执行两类研究：

1. 账号研究（Account research）——使用account-research技能获取完整账号快照；
2. 联系人研究（Contact research）——使用contact-research技能为每位外部参会者建立画像。

Common Room 数据是主数据源。完成 CR 研究后，对每家公司做一次快速的近期信息检查（recency check）——这是补充而非主数据源：

• 搜索"[company name]" news，时间范围限定在最近 7 天；
• 对高管级参会者，搜索其姓名近期的公开文章或访谈；
• 只收录真正值得注意的发现（融资、领导层变动、重大媒体报道），不要用泛泛的新闻填充简报。

深度校准（Depth calibration）：

• 对高优先级账号（大账号、进行中的机会、续约风险），产出完整深度研究；
• 对低优先级或短时会议，产出精简快照（每场 3–4 条要点）。

步骤 4：综合成周报

将所有逐场研究结果汇编成一份结构化文档，按会议日期/时间排序，并以周级别概览开篇，标记：

• 存在紧急信号的账号（有风险、试用即将到期、扩张机会）；
• 需要特殊准备或高管介入的会议；
• 外部会议总数与预计投入时间。

输出格式模板：周概览 + 按日分段的逐场简报

SKILL.md 给出了完整输出模板，是每周简报的标准骨架：

# Weekly Prep Brief — Week of [Date] ## Week Overview [2–4 bullets: key themes, flagged priorities, call count] --- ## [Monday / Tuesday / etc.] ### [Company Name] — [Time] **Attendees:** [Names and titles] **Meeting type:** [Discovery / QBR / Renewal / Expansion / etc. — inferred if possible] **Company Snapshot** [4–5 bullets: account status, top signals, recent activity] **Attendee Profiles** - **[Name]** ([Title]): [2–3 bullets on their signals, persona, conversation angle] - [Repeat per attendee] **Top Signals This Week** [2–3 most relevant signals for this specific call] **This Week's News** [If notable news found] [Only genuinely noteworthy findings — funding, leadership changes, major press] **Recommended Objectives** [1–2 sentences: what to accomplish in this meeting] --- [Repeat per meeting, sorted by date/time]

注意模板中的几个设计意图：Meeting type允许在可能时推断会议类型；This Week's News被显式标注为「仅真正值得注意的发现」；每场会议都以明确的Recommended Objectives收尾，把研究落回到「这场会要达成什么」的行动层面。

稀疏数据降级：宁要诚实短文，不要编造长文

这是该技能最核心的质量红线。当 Common Room 对某场会议的账号或参会者只返回有限数据时，该会议改用压缩格式，而不是套用完整模板：

### [Company Name] — [Time] ⚠️ Limited Data **Attendees:** [Names and titles if known] **Data available:** [What Common Room actually returned] **Web Search Results** [Findings from web search — company news, attendee LinkedIn profiles] **Note:** Common Room has limited data on this account. The rep may want to check directly in CR or gather context from colleagues before this call.

规则明确：不得基于稀疏数据生成完整的会议准备段落（公司快照、信号高亮、谈话要点、推荐目标）。这一「诚实优先」原则与插件内其他技能一脉相承——account-research技能（见 SKILL.md）在处理稀疏数据时同样要求如实说明 "There is limited information available for this account."，绝不猜测或用泛泛陈述填充；contact-research技能（见 SKILL.md）也规定不得从稀疏数据生成谈话开场白、人物画像推断或参与度评估。三者共同遵循同一条铁律：简报中的每一个事实都必须来自工具调用，禁止编造交易背景、活动或信号。

质量标准与阅读时限

SKILL.md 定义了周报必须满足的质量标准：

• 可扫描性：每个会议小节保持紧凑，因为销售代表通常是在早晨（经常是在手机上）阅读；
• 始终按日期/时间升序排序；
• 紧急情况醒目提示：风险、试用到期、进行中的机会必须显眼呈现，不要埋没在正文里；
• 稀疏数据必须用降级格式：绝不用猜测填满完整模板；
• 阅读时限：一周 4–6 场会议时，整份简报应在 10–15 分钟内读完（对应命令文档/weekly-brief的 10 分钟上限）；
• 事实来源：每个事实都必须来自工具调用，不编造交易背景、活动或信号。

深度与优先级：briefing-guide.md 的扩展规则

技能引用的 references/briefing-guide.md 对简报结构与边界情况做了系统化补充，与 SKILL.md 构成完整的备战规范。

按账号类型校准研究深度

这张表把 SKILL.md 中的「深度校准」具体化为六档可判定的规则，核心思路是：研究深度与研究价值成正比——大客户和关键机会做全量，小账号快速跟进做最小化。

周概览优先标记清单

以下情况必须在简报顶部显著标记：

• 试用将在 7 天内到期、续约在 30 天内到期，或检测到流失风险信号；
• 有待处理的关键支持工单或未解决的升级事件；
• 值得在会议中提出的扩张信号；
• 有高管利益相关者或新 champion 参会；
• Champion 近期更换工作，或账号出现竞争信号；
• 公司近期融资、产品里程碑或强社区背书（可作为开场话题）。

边界情况处理

• 无 Common Room 数据：明确标注，运行外部网络研究，并建议代表与团队核实离线背景信息；
• 同一公司多场会议：账号只研究一次，跨会议共享，用参会者与目标做差异化；
• 一周 7+ 场会议：询问用户是为特定账号做全量研究，还是对所有会议做精简备战；默认对战略客户做全量；
• 当天会议：跳过确认环节，直接产出压缩版（公司快照 + 顶级信号 + 1–2 个谈话要点），并标记为 "[Quick Prep]"；
• 已取消会议：静默排除；若状态不明，保留并标注 "[Status unclear — confirm this meeting is still on.]"。

与上下游技能的分工协同

weekly-prep-brief 之所以能「一场会议产出全套备战材料」，是因为它复用了插件的两个基础研究技能，而不是各自重新实现一遍数据逻辑：

• account-research（SKILL.md）处理四种交互模式：完整概览、定向字段提问、稀疏数据场景、MCP 数据 + LLM 推理。周报中的Company Snapshot直接对应其完整概览输出，且其字段选择规则（Scores 一律返回原始值或百分位数而非标签；Summary research 即 RoomieAI 输出是最丰富的定性信号；Top contacts 按分数降序）决定了周报中信号描述的口径；
• contact-research（SKILL.md）支持按邮箱、社交账号或姓名+公司查找联系人，返回活动历史、Spark、分数、网站访问与 CRM 字段。周报中的Attendee Profiles直接受益于其两个关键实践：以Contact Initiated过滤（最近 60 天）的客户主动活动为首要参与度信号；Spark 不可用时如实说明，绝不单凭职位头衔臆造人物画像；
• 会议类型的推断可参考call-prep的 call-types-guide.md：试用 + 早期信号 = Discovery/Demo；CRM 中有进行中的机会 = Demo/Evaluation/Negotiation；老客户 + 续约日期 = Renewal/QBR；扩张信号 = Expansion；支持工单 + 使用量下滑 = Save call；
• 信号高亮的解读口径可参考account-research的 signals-guide.md 中四个信号类别（产品/社区/意向/关系）及四条解读原则——时效性优先、信号簇强于单一信号、信号缺失本身即是信号、结合账号阶段解读。

实操落地：如何使用本技能

1. 连接 Common Room MCP：在 Cowork 设置中连接并认证mcp.commonroom.io/mcp，这是本技能数据来源的前提（详见 CONNECTORS.md）；
2. （可选）连接日历：安装兼容的日历 MCP 服务器（如 Google Calendar）并认证，即可自动获取未来 7 天的外部会议；未连接时技能会回退到手动询问，因此日历并非必需；
3. 触发技能：直接以自然语言请求，例如 "Prepare my week" 或 "Weekly prep brief"；也可使用显式命令/weekly-brief [date range]并指定时间范围（默认未来 7 天）；
4. 确认会议清单：技能会先呈现识别到的外部会议供你增删，确认后才开始逐场研究，避免无效研究消耗；
5. 阅读与行动：按日期升序阅读周报，优先处理 Week Overview 中标记的紧急账号，再逐场落实 Recommended Objectives。

小结

weekly-prep-brief 的完整能力闭环可以概括为一条链：日历抓取外部会议 → 清单确认 → 并行账号/联系人研究 + 7 天新闻时效检查 → 按深度规则逐场产出 → 汇总为可 10–15 分钟读完的周报。其设计哲学贯穿始终：Common Room 是主数据源、web 搜索只做时效补充、稀疏数据诚实降级、每个事实必须可溯源到工具调用。配合briefing-guide.md的深度校准表与边界情况规则，这套流程既能支撑战略客户的全量备战，也能在一周 7+ 场会议的忙碌节奏下保持产出效率与诚实底线。

【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins