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

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

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

小夜