内部沟通文档撰写:用 Skill 统一内部沟通稿格式

前言

内部沟通稿(周报、管理层通报、事故说明等)往往要同时满足「结构清晰」和「语气一致」。若每次都在对话里重复说明章节、受众和禁忌用语,Agent 产出的版式容易漂移。下面介绍 SkillHub 上的 内部沟通文档撰写(@org-02qudk26/internal-comms):把文档类型、加载哪份指南、按什么格式写等规则写进 SKILL.md,在触发撰写任务时由 Agent 按同一套流程执行。

这是什么

内部沟通文档撰写 是一套面向 Agent 的技能资源,定位是:在需要撰写各类内部沟通文件时,按组织常用的格式与流程组织内容。SkillHub 页面与包内元数据一致,当前版本为 1.0.0,坐标 @org-02qudk26/internal-comms,分类 office-efficiency,来源标注为 enterprise,发布者为 智雨科技。标签 requires_api_key=false,不依赖额外 API Key。

官方入口:

  • SkillHub 展示页:https://www.skillhub.cn/skills/org-02qudk26/internal-comms
  • API 坐标页:https://api.skillhub.cn/org-02qudk26/internal-comms

核心功能

能力以包内 SKILL.md 为准,可核实要点如下。

适用文档类型

在撰写内部沟通文件时,技能说明中列出的类型包括:

  • 3P 更新(进度、计划、问题)
  • 公司新闻稿
  • 常见问题解答(FAQ)
  • 状态报告
  • 管理层更新
  • 项目更新
  • 事件报告

包内 description 与上述列表一致,并约定:当被要求撰写上述内部沟通文件时,应启用此技能。

使用流程

SKILL.md 规定的步骤为:

  1. 确定沟通类型——从用户请求中判断属于哪一类文稿。
  2. 加载 examples/ 下对应指南(技能文档中列出的文件名):
    - examples/3p-updates.md — 进度 / 计划 / 问题类团队更新
    - examples/company-newsletter.md — 公司级新闻稿
    - examples/faq-answers.md — 常见问题答复
    - examples/general-comms.md — 未明确归入前三类时的通用内部沟通
  3. 按该指南中的说明处理版式、语气与需收集的信息。

若请求无法对应现有指南,应向用户追问澄清或补充格式要求。

README 中的能力说明

同包 README.md 将能力概括为:为内部公告、决策说明、项目状态、变更通知和敏感议题建立清晰、可执行的沟通结构,并强调影响范围、时间、行动项、责任与反馈路径等要素。文中以维护通知、组织调整、项目延期三类场景说明应写清的内容边界(属技能自带说明,非第三方用户反馈)。

注意: 通过 SkillHub CLI 安装得到的 v1.0.0 包中,当前仅包含 SKILL.md、README.md、_meta.json,未包含 SKILL.md 所引用的 examples/ 目录。启用技能后,Agent 仍可按类型与流程工作,但若需严格按指南文件执行,需自行核对商店包是否已补齐示例,或在组织内维护同名指南文件。

安装与启用

安装方式以 SkillHub 官方文档为准:先按 SkillHub 安装与优先源配置 准备 skillhub CLI,再将技能安装到当前 Agent 识别的 skills 目录(安装时必须使用 --dir,否则默认落在 ./skills/ 且可能不被识别)。

检查 CLI:

command -v skillhub && skillhub --version

未安装时可执行(完整安装,含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本技能(slug 需带命名空间前缀):

skillhub install @org-02qudk26/internal-comms --dir <你的 Agent skills 目录>

常用客户端 skills 路径(摘自官方安装文档):

客户端 路径
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/

也可将官方页面给出的提示交给 Agent:根据 https://skillhub.cn/install/skillhub.md 安装 @org-02qudk26/internal-comms。安装后按所用客户端要求重启或刷新 Agent,使技能被加载。

典型用法

技能为 SKILL.md 驱动,无独立 CLI 子命令。典型交互方式如下。

  1. 在已安装技能的 Cursor / Claude Code 等环境中打开对话。
  2. 用自然语言说明要写哪类内部稿,并给出事实材料(时间线、影响范围、待决策项等)。示例表述(可替换为你的真实背景):
请用内部沟通文档撰写技能,写一份 3P 更新:本周进度、下周计划、当前阻塞项。
背景:……(粘贴要点)
  1. Agent 应按 SKILL.md 先判定类型,再尝试加载对应 examples/*.md 并按指南组织正文;类型不清时应反问格式要求。

关键词(技能文档列出,便于触发或检索):3P 更新、公司新闻稿、公司沟通、每周更新、常见问题、FAQ、更新、内部沟通。

适用场景与注意

适合谁

  • 需要反复产出状态报告、管理层更新、FAQ、事件报告等内部文稿的工程师、项目经理或内勤岗位。
  • 希望 Agent 在「写什么类型 → 跟哪份指南 → 语气与结构」上行为一致,而不是每次从零描述版式的团队。

限制与注意

  • 包内容: 当前下载包未附带 examples/ 指南文件,与 SKILL.md 文字描述不一致;落地前建议在本地或内网补齐指南,或关注 SkillHub 后续版本是否更新包体。
  • 格式归属: 技能描述为「公司常用格式」,具体版式以你组织内维护的 examples 或 README 原则为准,生成稿仍需人工审核敏感信息与合规表述。
  • 商店数据: SkillHub 抓取信息为评分 100000、下载 2496、安装 0(以页面/索引为准,会随时间变化)。
  • 同名技能: 商店搜索存在其他 internal-comms 变体,安装时请确认坐标 @org-02qudk26/internal-comms,避免装错包。

结尾

内部沟通文档撰写 把内部文稿类型与撰写流程固化在 Agent Skill 中,适合把 3P 更新、新闻稿、FAQ、事件报告等重复性写作交给 Agent 按同一套路处理。使用前确认 skills 目录与包内文件是否完整,并在发布前做人工校对。

官方地址:https://www.skillhub.cn/skills/org-02qudk26/internal-comms

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

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

小夜