internal-comms:让 AI 按公司格式写内部沟通文档

前言

每周写 3P 周报、整理全员 Newsletter、回复 FAQ、起草事故通报——这些内部沟通文档格式各异、受众不同,却都要在有限篇幅里把信息讲清楚。手写一遍不难,难的是每次都要回忆「我们团队到底用什么模板、什么语气、多长合适」。

Anthropic 在官方 Skills 仓库里提供了一个叫 internal-comms 的 Skill:把各类内部沟通文档的写作规范打包成可复用的指令集,让 AI 代理在 Cursor、Claude Code 等工具里按既定格式产出内容。它代表 Agent Skills 从「写代码、做设计」向「职场协作与生产力」延伸的一个典型方向。

这是什么

internal-commsanthropics/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 里,分三步:

  1. 从用户请求中识别沟通类型
  2. examples/ 目录加载对应的指南文件
  3. 按该文件中的格式、语气与信息收集要求完成写作。

各指南文件职责如下:

指南文件 适用场景
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.mdexamples/ 子目录和 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 中使用

根据 anthropics/skills README

  • 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 的工作流不变,只是规范来源换成你的文件。

限制与注意

  1. 演示性质:anthropics/skills README 注明,这些 Skill 主要用于演示与教育,生产环境使用前需充分测试。
  2. 不替代事实核查:代理会按你提供的材料格式化;若输入有误,输出也会有误。事故报告、政策 FAQ 等务必人工审核后再发布。
  3. 工具集成非必需:指南中提到的 Slack、Email 等是「若有则用」;纯文本输入同样可用。
  4. 无匹配模板时会追问:类型不明确时,Skill 要求代理向用户确认格式,避免强行套用错误模板。

小结

internal-comms 把「内部沟通怎么写」从个人经验变成了可版本管理、可团队共享的 Skill 包。它不生成花哨文案,而是帮你守住格式、篇幅和语气——正好对应企业场景里「写得对、写得快、写得一致」的需求。

若你已在用 Cursor 或 Claude Code,不妨把官方目录拷进 Skills 路径,用一次 3P 周报或 FAQ 整理试试;若要贴合自家风格,从改 examples/ 里的四个 Markdown 文件开始即可。

官方地址:https://github.com/anthropics/skills/tree/main/skills/internal-comms

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜