前言¶
每周写 3P 周报、整理全员 Newsletter、回复 FAQ、起草事故通报——这些内部沟通文档格式各异、受众不同,却都要在有限篇幅里把信息讲清楚。手写一遍不难,难的是每次都要回忆「我们团队到底用什么模板、什么语气、多长合适」。
Anthropic 在官方 Skills 仓库里提供了一个叫 internal-comms 的 Skill:把各类内部沟通文档的写作规范打包成可复用的指令集,让 AI 代理在 Cursor、Claude Code 等工具里按既定格式产出内容。它代表 Agent Skills 从「写代码、做设计」向「职场协作与生产力」延伸的一个典型方向。
这是什么¶
internal-comms 是 anthropics/skills 仓库中的企业沟通类示例 Skill,由 Anthropic 维护,遵循通用的 SKILL.md 开放格式(详见 agentskills.io)。
它的定位很直接:当你需要撰写各类内部沟通材料时,代理会先识别文档类型,再从 examples/ 目录加载对应的格式指南,按公司惯用的结构、语气和篇幅要求生成草稿。
官方 SKILL.md 中明确支持的文档类型包括:
- 3P 更新(Progress / Plans / Problems,进展、计划、问题)
- 公司 Newsletter(全员通讯)
- FAQ 回复
- 状态报告
- 领导层更新
- 项目更新
- 事故报告
对于没有单独模板文件的类型(如状态报告、事故报告等),Skill 会回退到 examples/general-comms.md 中的通用原则,并在信息不足时主动向你确认受众、目的和语气。
核心功能与亮点¶
1. 分类型加载格式指南,而非「一把梭」¶
Skill 的核心工作流写在 SKILL.md 里,分三步:
- 从用户请求中识别沟通类型;
- 从
examples/目录加载对应的指南文件; - 按该文件中的格式、语气与信息收集要求完成写作。
各指南文件职责如下:
| 指南文件 | 适用场景 |
|---|---|
examples/3p-updates.md |
团队 3P 周报(Progress / Plans / Problems) |
examples/company-newsletter.md |
公司级 Newsletter |
examples/faq-answers.md |
汇总并回答员工常见问题 |
examples/general-comms.md |
其他未单独覆盖的内部沟通(含状态报告、事故报告等) |
这种「主 Skill 轻量、参考资料按需加载」的设计,与 Agent Skills 倡导的渐进式上下文加载一致:代理只在需要写某类文档时才读取对应模板,避免把全部规范一次性塞进上下文。
2. 内置多种企业沟通场景的写作规范¶
以 3P 更新 为例,官方指南要求:
- 受众为管理层、跨团队同事,30–60 秒可读完;
- 固定三段式:
Progress(本周完成)、Plans(下周计划)、Problems(阻碍与风险); - 每段 1–3 句,数据驱动,语气平实、不堆砌辞藻;
- 输出格式严格,例如:
[pick an emoji] [Team Name] (Dates Covered)
Progress: [1-3 sentences]
Plans: [1-3 sentences]
Problems: [1-3 sentences]
公司 Newsletter 指南则侧重:约 20–25 条 bullet、多用「we」视角、按产品/市场/招聘等分区、尽量附上 Slack 消息、Google Drive 文档、邮件等链接,并优先公司级影响而非团队细枝末节。
FAQ 指南要求以「问题 + 简短回答」成对呈现,基于官方沟通材料作答,不确定时明确标注,必要时链接权威来源。
3. 引导代理从协作工具拉取上下文¶
多个指南文件都提到:若代理能访问 Slack、Google Drive、Email、Calendar 等工具,应优先从这些渠道收集本周进展、公告和员工疑问;没有工具权限时,则向用户索取要点并由 Skill 负责格式化。这让 Skill 在「有集成环境」和「纯对话输入」两种模式下都能工作。
4. 企业协作场景的代表性示例¶
在 anthropics/skills 仓库的分类中,internal-comms 属于 Enterprise & Communication 技能集,与 docx、pdf 等文档类 Skill 并列。它展示的是:Skills 不仅能辅助创意与开发,也能把组织内部的沟通惯例固化下来,供团队成员复用。
安装与启用¶
internal-comms 是一个标准 Skill 目录,包含 SKILL.md、examples/ 子目录和 LICENSE.txt,无需额外依赖。
在 Cursor 中使用¶
Cursor 会从以下路径自动发现 Skill(官方文档):
- 项目级:
.cursor/skills/或.agents/skills/ - 用户级:
~/.cursor/skills/或~/.agents/skills/
将官方目录复制到对应位置即可:
git clone https://github.com/anthropics/skills.git
mkdir -p ~/.cursor/skills
cp -r skills/skills/internal-comms ~/.cursor/skills/
若希望团队共享,可放到项目根目录:
mkdir -p .cursor/skills
cp -r skills/skills/internal-comms .cursor/skills/
重启 Cursor 或在 Customize → Skills 中确认 Skill 已被发现。代理会根据 description 字段自动判断是否启用,也可在 Agent 对话中输入 /internal-comms 手动调用。
在 Claude Code 中使用¶
Anthropic 官方 README 提供了 Plugin 安装方式。internal-comms 包含在 example-skills 插件集中:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
安装后,在对话中提及「写 3P 更新」「起草 Newsletter」等需求即可触发;也可直接说明「使用 internal-comms skill」。
在 Claude.ai 与 API 中使用¶
- Claude.ai:示例 Skill 已对付费计划用户开放;自定义 Skill 的上传方式见 Using skills in Claude。
- Claude API:可通过 Skills API 使用预置或上传的 Skill,参考 Skills API Quickstart。
在 Codex CLI 等兼容工具中使用¶
Cursor 文档注明,为兼容 Claude 与 Codex 生态,也会扫描 .codex/skills/ 与 ~/.codex/skills/。将 internal-comms 目录放到对应路径即可,具体行为以各工具文档为准。
典型用法示例¶
安装完成后,你不需要记忆模板细节,用自然语言描述需求即可。以下是基于官方指南的可复现示例。
示例 1:撰写团队 3P 周报¶
请用 internal-comms skill,为「Platform 团队」写本周 3P 更新。
时间范围:8 月 1 日–8 月 7 日。
Progress:上线了新的日志聚合面板,P99 延迟下降 12%。
Plans:下周对接告警规则迁移。
Problems:测试环境磁盘配额不足,影响集成测试。
代理会加载 examples/3p-updates.md,输出符合固定格式的三段式更新,并控制每段篇幅。
示例 2:起草公司 Newsletter¶
帮我写一份 8 月第二周的公司 Newsletter,面向 1000+ 员工。
重点包括:Q3 产品路线图发布、完成 B 轮融资、All-Hands 录像链接。
语气用「we」,每条 1–2 句,按产品、市场、文化分区。
代理会参照 examples/company-newsletter.md,生成带分区标题和 bullet 列表的通讯草稿,并提示你补充 Slack / 文档链接。
示例 3:整理 FAQ¶
最近员工在 Slack #general 里反复问新办公政策和远程天数,
请整理成 FAQ,每条包含问题和 1–2 句回答。
代理会加载 examples/faq-answers.md,以「Question / Answer」成对输出,并建议链接官方政策文档。
示例 4:事故报告(通用沟通)¶
昨晚 23:00–23:45 支付服务出现 5xx 峰值,已回滚。
请写一份面向全员的简短事故通报,语气正式、先结论后细节。
由于没有单独的事故报告模板,代理会使用 examples/general-comms.md:先确认受众与语气,再按「重要信息前置、主动语态、简洁明了」的原则起草。
适用场景与注意事项¶
适合谁用¶
- Team Lead / PM:每周 3P、项目状态更新;
- HR / 内部沟通:全员 Newsletter、政策 FAQ;
- SRE / 值班工程师:事故通报、事后说明初稿;
- 希望统一团队写作规范的人:把
examples/改成自己公司的模板即可。
自定义建议¶
官方示例模板偏英文硅谷协作语境(Slack、Google Drive、emoji 标题等)。国内团队可将 examples/ 下的 Markdown 替换为自有格式——例如改用飞书文档结构、中文段落习惯、固定抬头落款——Skill 的工作流不变,只是规范来源换成你的文件。
限制与注意¶
- 演示性质:anthropics/skills README 注明,这些 Skill 主要用于演示与教育,生产环境使用前需充分测试。
- 不替代事实核查:代理会按你提供的材料格式化;若输入有误,输出也会有误。事故报告、政策 FAQ 等务必人工审核后再发布。
- 工具集成非必需:指南中提到的 Slack、Email 等是「若有则用」;纯文本输入同样可用。
- 无匹配模板时会追问:类型不明确时,Skill 要求代理向用户确认格式,避免强行套用错误模板。
小结¶
internal-comms 把「内部沟通怎么写」从个人经验变成了可版本管理、可团队共享的 Skill 包。它不生成花哨文案,而是帮你守住格式、篇幅和语气——正好对应企业场景里「写得对、写得快、写得一致」的需求。
若你已在用 Cursor 或 Claude Code,不妨把官方目录拷进 Skills 路径,用一次 3P 周报或 FAQ 整理试试;若要贴合自家风格,从改 examples/ 里的四个 Markdown 文件开始即可。
官方地址:https://github.com/anthropics/skills/tree/main/skills/internal-comms