📚 沟通写作全难度 📦 Anthropic

internal-comms

企业内部沟通模板（周报、状态更新、3P 更新）。

8.2 /10 ★★★★☆

📅 2026-06-15 · 🕒 4 分钟阅读 · 最后更新 2026-06-15 · 来源: Anthropic · 分析测评

#Anthropic#internal-comms

📄 相关文章

📊 评分明细

⚡ 功能完备度

8.2 核心功能齐全

🎯 易用性

7.9 安装即用

🔧 可扩展性

8 声明式配置

🔗 生态协同

8.1 可链式调用

🛡️ 稳定性

8.5 内置验证流程

🎯 适用场景

Anthropicinternal-comms

internal-comms 快速入门

周报、状态更新、事故通报 3 步搞定——这个 Skill 教 AI 按 3P 框架写出专业、有信息量的内部沟通。

这是什么?解决什么问题?

internal-comms(slug anthropic-internal-comms)是 Anthropic 在 anthropics/skills 仓库下沉淀的企业沟通 Skill。它把内部高频沟通场景整理成结构化模板,包括:

3P 更新(Progress / Plans / Problems):硅谷最常用的状态报告;
周报 / 周会材料:个人/团队双视角;
决策日志(Decision Log):记录 ADR(Architecture Decision Record)风格;
事件通报(Incident Update):线上事故中的 SRE 沟通模板;
项目启动 / 收尾(Kickoff / Retrospective);
跨团队协调请求:说清楚 ask / context / impact / deadline;
高层简报(Executive Summary):为非技术读者服务。

普通员工写周报最常见的痛点是:

一周做了一堆事,流水账罗列 30 条,老板看不出重点;
区分不了 progress / plan / problem,问题埋在细节里;
用技术黑话写给非技术读者,信息传不到决策层;
风险信号太晚暴露,出问题才被发现。

internal-comms Skill 把这些问题沉淀成 Agent 提示词,让 Claude Code / Cursor 等在你说“帮我写周报”时,主动追问:

周期(本周 / 本月 / 本季度)?
受众(团队 / 部门 / 高管 / 跨部门)?
关键指标达成率?
最大风险?
需要的支持 / 决策?

适合产品经理、Tech Lead、SRE、咨询顾问、企业内训师,以及任何每周都要写汇报的打工人。

准备工作

AI 编程 Agent / 通用对话工具:Claude Code / Claude.ai / Cursor 都可以。
本周/本月工作的事实清单:哪怕只是 bullet 也行,Agent 帮你润色。
可选:Notion / Confluence / 飞书:Skill 输出可直接粘贴。

3 步快速上手

第 1 步:克隆仓库

git clone https://github.com/anthropics/skills.git
cd skills/skills/internal-comms
ls

第 2 步:让 Agent 加载 Skill

CLAUDE.md:

# CLAUDE.md
When I ask for weekly updates, status reports, or executive summaries,
read anthropics/skills/skills/internal-comms/SKILL.md and follow the
3P (Progress / Plans / Problems) format strictly.

第 3 步:用 Skill 跑第一份周报

我是某 SaaS 公司的后端工程师,这周做了这些事:

完成支付模块重构,上线后 P99 延迟从 800ms 降到 300ms

处理了 3 个生产 bug,其中 1 个导致 2 小时部分用户无法登录

与产品对了一次 Q3 路线图

带了一个实习生,review 了 4 个 PR

读了一半《Designing Data-Intensive Applications》第 7 章请用 internal-comms Skill 帮我写一份给 Tech Lead 的周报。

Agent 会输出:

# 周报 — 2026-06-09 ~ 2026-06-15

## Progress
- 支付模块重构完成上线,P99 延迟从 800ms → 300ms(↓ 62%),资源消耗下降 25%。
- 处理 3 个生产 bug:
  - Bug-1421 短信验证码偶发失败(已修)
  - Bug-1430 部分用户登录失败 2 小时(已修,根因:缓存击穿,已加 mutex)
  - Bug-1438 webhook 重试导致重复扣款(已修,加 idempotency key)
- 与产品对齐 Q3 路线图,确认支付 + 退款自动化是 P0。

## Plans
- 下周完成退款流程自动化(预计 5 天)
- 推进《DDIA》第 7-8 章阅读,产出 1 页学习笔记
- 实习生收尾:完成 onboarding 文档补全

## Problems
- 数据库主库 CPU 持续在 70% 警戒线,需要 7 月前完成读写分离。
  Ask: 需要 DBA 团队支持评估方案,本周或下周一次 30 分钟同步。
- 周二那次 2 小时事故复盘发现监控缺失,需要补 Prometheus 告警规则。
  Ask: 平台组能否下周给出告警规则模板?

常见踩坑

没有量化指标:“做了支付优化”远不如“P99 800ms → 300ms”。Skill 提示 Agent 主动追问量化数据。
Problem 写得避重就轻:很多人把 problem 写成 “有个小 bug 已修”,Skill 强制要求暴露真正风险和 ask。
目标读者错配:技术 Lead 想看架构决策,CEO 想看业务影响。Skill 提示根据受众切换详略。
3P 不分清楚:把 plan 写进 progress,把 problem 写进 plan,Skill 提供反例清单。
决策日志缺 alternative:ADR 风格要写清“考虑了哪些方案、各自优劣”,Skill 强调不能只写最终选择。
事件通报缺 timeline:SRE 通报必须有 time-stamped timeline,Skill 提示强制字段。

初级用法

1. 个人周报

这是我本周的工作事实清单,请用 internal-comms Skill 给我写一份给 Tech Lead 的 3P 周报。

2. 团队状态更新

我们团队这周完成了 X、Y、Z,下个 milestone 是 M,有几个 blocker。请生成团队更新。

3. 事故通报

6 月 12 日 10:00 - 12:00,我们生产环境有 2 小时故障,请用 internal-comms Skill 写事件通报,受众是全公司。

高级玩法

1. 季度复盘

Skill 提示把 12 份周报聚合,生成 QBR(Quarterly Business Review)材料。

2. 高管简报

请把这份技术周报转写成给 CEO 看的 1 页简报,只保留业务影响、关键风险、决策请求。

3. 跨团队 ask 模板

[Ask]     需要 XX 团队在 6/30 前提供 XX 能力
[Context] 背景,1 段
[Impact]  不做会怎样(业务/技术)
[Deadline] 硬截止
[Owner]   谁来负责

4. 决策日志 ADR

# ADR-007: 选用 PostgreSQL 替代 MySQL

## Context
[背景]

## Decision
[决策]

## Status
Accepted / Proposed / Deprecated

## Consequences
[影响,正反两面]

## Alternatives Considered
- MySQL 8.0
- TiDB

小技巧

每周五下午固定时间写周报:形成习惯,避免拖到周日晚上焦虑。
量化 + 链接:每个 progress 都带 1 个数字 + 1 个链接(文档/issue/PR)。
problem 必带 ask:光报问题不给解决方案,周报就成吐槽大会。
3P 顺序很重要:先讲做成的(Progress),再说接下来做的(Plans),最后说阻塞(Problems),让读者带着好奇心读下去。
每季度写一份 retrospective:把过去 12 周的 problem 聚类,发现系统性瓶颈。

常见问题 FAQ

Q1: 这个 Skill 跟 internal-comms 有什么关系?必须装吗?

A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?

A: internal-comms 来自 Anthropic,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?

A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了?

A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗?

A: 取决于 internal-comms 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

参考链接

Anthropic Skills 总仓库:https://github.com/anthropics/skills
internal-comms 子目录:https://github.com/anthropics/skills/tree/main/skills/internal-comms
3P 框架原文:https://www.atlassian.com/agile/project-management/example-progress-report
ADR 模板:https://github.com/joelparkerhenderson/architecture-decision-record
Google SRE Book — Incident Response:https://sre.google/sre-book/managing-incidents/
高管简报技巧:https://hbr.org/topic/subject/communication
飞书周报模板:https://www.feishu.cn/hc/zh-CN/articles/000000000000-weekly-report
QBR 写作指南:https://www.cascade.app/blog/qbr-template

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。

internal-comms Skill 多维度简评

类别：企业沟通 / 文案模板仓库：anthropics/skills 维护者：Anthropic 官方

一、核心定位与价值

internal-comms 是 Anthropic 官方 17 个 Skill 中**最偏向”非技术”**的——专门用于生成企业内部沟通文档。它把 Anthropic 自己内部的沟通模板沉淀成 SKILL.md，覆盖 7 种典型场景：

通信类型	英文名	适用场景
3P 更新	3P updates	Progress / Plans / Problems 进展汇报
公司通讯	company newsletter	内部全员邮件
FAQ 回复	FAQ response	客户/员工常见问题
状态报告	status report	项目里程碑汇报
领导层更新	leadership update	高管简报
项目更新	project update	团队内部同步
事件报告	incident report	生产事故复盘

关键洞见：企业级沟通有”标准结构”——Anthropic 把这些模板固化下来，AI 写出来就是”大厂味”。

适用场景

写周报 / 月报 / 季报
准备高管汇报
编写生产事故复盘
起草客户 FAQ
跨部门项目同步
内部 newsletter

不适用场景

客户面向的市场文案（用 brand-guidelines）
严肃的技术文档（用 doc-coauthoring）
对外公告（用品牌公共关系 Skill）
个人日记 / 博客

二、7 大模板详解

2.1 3P 更新（Progress / Plans / Problems）

结构：

## Progress（本周完成了什么）
- 完成项 1 + 数据
- 完成项 2 + 数据
- 完成项 3 + 数据

## Plans（下周计划做什么）
- 计划 1 + 负责人
- 计划 2 + 负责人
- 计划 3 + 负责人

## Problems（遇到的问题 / 风险）
- 问题 1 + 影响 + 需要的支持
- 问题 2 + 影响 + 需要的支持

## Asks（具体请求）
- 请求 1（决策 / 资源 / 介绍）
- 请求 2

实战示例：

## 3P Update - 推荐系统 v2 项目（Week 14）

### Progress
- 上线 A/B 实验，覆盖 10% 流量，点击率提升 12%
- 召回链路性能优化，P99 延迟从 200ms 降到 80ms
- 团队 blog 发布《向量召回在电商场景的实践》阅读 1.2k
- 完成 Q3 OKR 设定与团队对齐

### Plans
- 下周一前完成全量上线（owner: 张三）
- 完成排序模型蒸馏，期望 CTR +3%（owner: 李四）
- 启动冷启动方案调研（owner: 王五）
- 招聘进度：1 高级工程师 offer 发放中

### Problems
- GPU 资源紧张，影响实验节奏（影响：2 周延期风险）
  - 需要：CTO 协调 8 张 A100
- 特征平台对深度模型支持不完善（影响：1 工程师 50% 时间 hack）
  - 需要：基础平台组 1 人 1 sprint 协助

### Asks
- 决策：是否对历史订单做 embedding（影响成本 ~$5k/月）
- 资源：A100 配额
- 介绍：清华计算机系做推荐的教授（学术合作）

Skill 强制要求：

3 个 P 各 3-5 个 bullet
每个 bullet 含数据 / 负责人 / 影响
至少 1 个 Asks
字数控制在 800 字内

结构：

## 本期亮点（TL;DR）
- 3 句话总结本月最重要的事

## 业务进展
- 收入 / 用户 / 产品 / 客户故事

## 团队大事
- 招聘 / 晋升 / 新人
- 文化活动 / 培训

## 即将到来
- 下月重要里程碑
- 大会 / 活动 / 发布

## 致谢
- 本月突出贡献者

实战示例：

# 2026 年 6 月全员通讯

## TL;DR
- 月活突破 1000 万 🎉（同比 +180%）
- 完成 C 轮 5000 万美元融资（红杉领投）
- 团队规模扩展到 85 人（+12）

## 业务
- 收入：$2.3M MRR（环比 +18%）
- 签约客户：新增 23 家，含 3 家世界 500 强
- 客户故事：字节跳动用我们的平台提升 25% 效率

## 团队
- 🎉 欢迎 12 位新同事（详见附件名单）
- 🏆 晋升：Lisa 升为 Engineering Director
- 📚 内部分享会：8 场（平均参与 35 人）
- 🎁 端午礼物：定制礼盒已发货

## 即将到来
- 7/15：产品发布会
- 7/20：Q2 All Hands
- 8/01：夏季团建（杭州）

## 致谢
特别感谢产品组的 Mike，连续 3 周每天工作到 11 点，扛住了 C 轮 due diligence 准备

2.3 FAQ 回复

结构：

## 问题
（客户原话或简要复述）

## 简短回答
（一句话直接答案）

## 详细解释
- 背景
- 技术细节 / 业务逻辑
- 例子

## 相关问题
- Q1
- Q2

## 联系方式
- 邮件 / 文档 / 升级路径

2.4 状态报告（Status Report）

结构：

## 项目名称
- 周期：2026-06-01 至 2026-06-30
- 报告人：张三
- 总体状态：🟢 绿 / 🟡 黄 / 🔴 红

## 关键指标
- 进度：X% 完成（计划 Y%）
- 预算：$X / 预算 $Y
- 风险：X 个 High，Y 个 Medium

## 本月完成
- ...

## 本月未完成 + 原因
- ...

## 下月计划
- ...

## 风险 / 阻塞
- ...

## 决策请求
- ...

颜色规则：

🟢 绿：按计划进行，无重大风险
🟡 黄：轻微偏离或潜在风险
🔴 红：重大偏离或需要立即关注

2.5 领导层更新（Leadership Update）

结构：

## 30 秒摘要（如果只看一段）
（一段话：现在在哪 / 下一步 / 需要什么）

## 关键指标仪表板
- 收入 / 增长 / 留存 / NPS
- 团队 / 招聘 / 离职率
- 产品 / 里程碑
- 客户 / 满意度

## 战略进展
- 本季度 OKR 进度
- 重要决策与结果

## 风险 / 机会
- 3 个最关键风险
- 3 个最大机会

## 资源请求
- ...

特点：

数字驱动（少用形容词）
30 秒可读完
风险和机会对称呈现
行动导向

2.6 项目更新（Project Update）

结构：

## 项目名称 + 当前阶段
（例：支付系统重构 - Phase 2）

## 关键里程碑
- ✅ Phase 1: 数据迁移（完成 6/5）
- 🟡 Phase 2: 双写验证（进行中，70%）
- ⬜ Phase 3: 切流量（计划 6/25）

## 关键决策
- 决策 1（日期 + 内容 + 理由）
- 决策 2

## 阻塞 / 风险
- 阻塞 1 + 升级路径

## 下周交付
- 交付 1
- 交付 2

2.7 事件报告（Incident Report）

结构：

## 概要
- 时间 + 持续时长 + 影响
- 一句话总结

## 影响
- 受影响用户数
- 受影响功能
- 收入损失（如可估算）
- SLA 违约情况

## 时间线（Time Line）
- T+0: 告警触发
- T+5min: 工程师响应
- T+15min: 根因定位
- T+30min: 修复上线
- T+45min: 监控恢复
- T+2h: 完全恢复

## 根因分析（5 Whys）
- Why 1: ...
- Why 2: ...
- Why 3: ...
- Why 4: ...
- Why 5: 根本原因

## 改进措施（Action Items）
- [ ] 措施 1 + 负责人 + 截止日期
- [ ] 措施 2 + 负责人 + 截止日期

## 经验教训
- 做对了什么
- 哪些地方可以改进

三、完整工作流

3.1 触发词（自动应用）

“3P update” / “周报” / “weekly update”
“newsletter” / “全员邮件”
“FAQ response” / “常见问题”
“status report” / “状态报告”
“leadership update” / “高管简报”
“project update” / “项目更新”
“incident report” / “事故报告” / “复盘”

3.2 Step 1：场景识别

用户："写一份本周的项目更新"
Skill：自动识别为"项目更新（project update）"
      加载项目更新模板

3.3 Step 2：上下文收集

Skill 会问关键问题：

项目名称？
目标受众（高管 / 团队 / 全员）？
周期？
关键里程碑？
当前状态（颜色）？
关键决策？
阻塞？

3.4 Step 3：套用模板生成

# 项目更新 - 支付系统重构

## 当前阶段
Phase 2: 双写验证（70% 完成）

## 关键里程碑
- ✅ 6/05: 数据迁移完成
- 🟡 6/20: 双写验证（70%）
- ⬜ 6/25: 切流量 5%
- ⬜ 6/30: 全量切换

## 本周完成
- 双写一致性从 95% 提升到 99.5%
- 灰度监控告警阈值调优
- 团队 blog 发布《双写一致性保障实践》

## 关键决策
- 6/15 决定：放弃 MySQL 5.7 兼容性，仅支持 8.0+
  - 理由：避免旧版本性能问题
  - 影响：3 个下游服务需升级

## 阻塞
- 财务对账服务升级延迟 3 天
  - 影响：Phase 3 启动延后
  - 缓解：并行启动其他工作

## 下周交付
- 切流量 5%（计划 6/25）
- 财务对账服务升级完成
- 完成切流量 SOP 文档

3.5 Step 4：风格润色

Skill 强制：

bullet 短句（< 25 字）
数据驱动（多数字少形容词）
行动导向（“下周交付”而非”继续努力”）
主动暴露风险（不藏问题）
包含 Asks

四、与其他 Skill 配合

Skill	配合方式
brand-guidelines	应用公司品牌色 / 字体
doc-coauthoring	写更长技术文档
theme-factory	给 PPT 通讯加主题
pptx	把 newsletter 做成 PPT
docx	导出 Word 格式
pdf	导出 PDF 发送

五、5 条反合理化

借口	反驳
”我自己写更亲切”	模板省时 70%，员工更爱读
”团队人少不需要”	3 人团队也需对外部投资人汇报
”周报是负担”	没有周报，3 个月后没人知道在做什么
”写 3P 暴露问题”	不暴露问题 = 问题滚雪球
”模板死板”	模板是结构，不是措辞；内容灵活

六、5 条实战技巧

周报固定周五下午 4 点发：建立节奏
3P 控制在 800 字内：超过没人看
每条 Asks 必须具体：要资源说金额，要决策说选项
用 emoji 标状态（🟢🟡🔴）：视觉一眼看清
存档到 Notion / Confluence：跨季度可追溯

七、Q&A

Q: 必须用 Claude Opus 吗？ A: 任何 Claude 模型都能用，Opus 效果较佳。

Q: 跟 Slack 消息区别？ A: 内部沟通是结构化文档；Slack 是即时聊天。

Q: 适合远程团队吗？ A: 尤其适合。远程团队没有”茶水间八卦”，书面沟通是命脉。

Q: 中文支持？ A: 完美支持。Skill 同时处理中英文模板。

Q: 跟 1:1 区别？ A: 1:1 是私人对话；周报是广播式。

Q: 跟 OKR 区别？ A: 周报是过程记录，OKR 是目标管理；周报可引用 OKR 进度。

Q: 字数限制？ A: 3P ≤ 800 字，newsletter ≤ 1500 字，leadership update ≤ 500 字。

八、Prompt 模板

模板 1：周报

[项目] 支付系统重构 v2
[周期] 2026-W24 (6/10 - 6/16)
[团队] 张三、李四、王五
[本期关键完成]
- 上线 5% 灰度，转化率 +1.2%
- 完成 5 个核心接口迁移
- 招到 1 名高级工程师
[本期未完成]
- 财务对账（延后到下周三）
[下周计划]
- 切流量 20%
- 完成所有 P0 接口迁移
[风险]
- 数据库压力测试发现性能瓶颈
[Asks]
- DBA 组协助排查慢 SQL

模板 2：事故复盘

[事故时间] 2026-06-15 14:30 - 15:45（共 75 分钟）
[影响] 推荐服务不可用，10% 用户受影响，损失订单 ~$50k
[根因] 缓存击穿 + DB 连接池耗尽
[Time Line] T+0 告警 → T+5 响应 → T+15 定位 → T+45 缓解 → T+75 恢复
[5 Whys] ...
[改进措施] 5 条

模板 3：领导层简报

[季度] Q2 2026
[公司] XXX Inc.
[TL;DR] 收入 $2.3M (+18%)，月活 1000 万，团队 85 人，下季度重点是商业化
[核心数字] 5 个
[风险/机会] 各 3 个
[资源请求] $1.5M（海外扩张 + 招聘 8 人）

九、真实踩坑案例

案例 1：3P 写成了流水账

现象：3P 像日记流水账，缺乏结构。解决：用 Skill 模板严格分 3 段，每段 ≤ 5 个 bullet，每 bullet 包含数据 / 责任 / 影响。

案例 2：事故报告被 PR 化

现象：只写”我们多努力修复了”，避谈根本原因。解决：Skill 强制 5 Whys 根因分析，公开承认失误。

案例 3：领导层简报充满技术细节

现象：CTO 写”我们用了 Kafka 4.0 + Flink + Iceberg”。解决：Skill 强制”30 秒可读完”，技术细节放附件。

案例 4：周报全是 Plans 没有 Asks

现象：Plan 写得很满，但卡住的事没人帮。解决：Skill 强制至少 1 个具体 Asks（“请张总帮协调 DBA 资源 2 天”）。

案例 5：newsletter 像广告

现象：全写”我们又拿了 X 奖”，没团队故事。解决：Skill 强制 50% 内容是”团队 / 文化 / 人”。

案例 6：FAQ 答非所问

现象：用户问”什么时候支持 X 功能”，回答里全是技术细节。解决：Skill 强制”简短回答”在 1-2 句。

案例 7：事故报告没有时间线

现象：直接写”我们修了”，没记录响应过程。解决：Skill 强制分钟级时间线，方便复盘和合规。

案例 8：项目更新用主观词

现象：用”基本完成”、“差不多”、“快了”。解决：Skill 强制数据（“70% 完成，预计 6/25 上线”）。

十、安装

# Claude Code
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

# 通用
npx skills add anthropics/skills --skill internal-comms

十一、总结

核心价值：

7 种企业内部沟通模板
强制结构化、数据驱动
提升远程团队透明度
Anthropic 内部实战经验

适用人群：

所有需要写周报 / 月报的人
团队 Lead / Manager / Director
远程 / 分布式团队
创业公司创始人

投入产出比：⭐⭐⭐⭐⭐（5/5）—— 所有职场人必装。

何时不要用：

客户面向的市场文案（用 brand-guidelines）
严肃技术文档（用 doc-coauthoring）
学术论文
个人日记

配套文档：doc-coauthoring 文档 | brand-guidelines 品牌

参考资料

📦 快速安装

1 Git Clone

git clone https://github.com/anthropics/skills.git
cd skills/skills/internal-comms
ls