前言¶
每週寫 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