内部沟通写作技能
一套面向企业内部沟通的写作技能:按照公司惯用格式撰写状态报告、3P 更新、公司通讯、FAQ 和事故报告等文档。
该技能本身仅为提示词指引,不执行代码、不请求特权权限、不涉及敏感数据外发,风险面小;但示例文件引导代理读取 Slack/邮件/日历等外部数据源,未见对数据来源、隐私与确认机制的显式约束,回滚与隔离概念不适用也未声明,故未给满分。
指令自洽,四类沟通类型与示例文件一一对应,并有'无法匹配时询问用户'的兜底;但完全依赖宿主代理是否具备 Slack/Drive/邮件工具,未提供工具不可用时的结构化失败反馈,测试与边界用例缺失,静态评估上限为10。
触发关键词(3P updates、newsletter、FAQ、status report 等)清晰,受众与场景明确,并声明了不匹配时的澄清路径;但能力边界(如无公司内部工具时效果有限)仅在示例内间接提及,无中文支持或环境适配说明,故中档偏上。
SKILL.md 结构清晰、渐进式加载示例文件,许可证元数据存在;但 frontmatter 引用的 LICENSE.txt 在仓库中未见(仅有仓库级 MIT LICENSE),无版本号、变更记录或维护责任声明,示例文件(company-newsletter.md)含拼写错误(perhgaps),治理信息不完整。
提供了具体可用的格式模板(3P 严格格式、newsletter 分节与示例、FAQ 问答格式),核心写作任务可完成且直接可用;但大量价值依赖从外部工具抓取上下文,静态无法验证产出质量,边际价值证据有限,静态上限为7。
内容与格式规则可在源文件中审计,属可审计一手材料;但无针对该技能的测试、无第三方执行证据、无独立佐证,且内容疑似源自 Anthropic skills 仓库但未标注出处,静态上限为5。
- 技能引导代理读取 Slack、邮件、日历、Google Drive 等内部通信数据,使用时应注意企业数据的隐私与访问授权边界。
- 示例文件未随附 LICENSE.txt,且内容疑似移植自 Anthropic 官方 skills,出处未标注,商用需自行核查授权。
- 效果高度依赖宿主代理是否配置了 Slack/Drive 等工具;工具缺失时技能仅能做格式润色。
- 无中文场景适配说明,且公司上下文假设(如 1000+ 人规模)为英文企业环境定制。
- 本评估为静态源码审阅,未执行任何测试,产出质量未经实证。
这个 Skill 能做什么,适合哪些场景?
这是 Mini-Agent 仓库中捆绑的 15 个技能之一,位于 mini_agent/skills/internal-comms/。它本身不含可执行脚本,而是一套写作指南资源:根据请求的沟通类型,从 examples/ 目录加载对应的格式与语气指南,再按指南撰写文档。支持的类型包括 3P 更新(进展/计划/问题)、公司通讯、FAQ 回答、状态报告、领导层更新、项目更新和事故报告。如果请求的类型没有现成指南,技能会主动要求澄清目标格式。仓库整体为 MIT 许可,采用 uv 安装并配合 MiniMax M2.5 模型运行。
技能的执行流程是纯指令型的:1) 从用户请求中识别沟通类型(如 3P 更新、公司通讯、FAQ 等);2) 从 examples/ 目录加载对应的指南文件——examples/3p-updates.md、examples/company-newsletter.md、examples/faq-answers.md 或兜底的 examples/general-comms.md;3) 按该文件中规定的格式、语气和信息收集方式撰写内部沟通文档。它读取仓库内的指南文件和用户的请求内容,产出符合格式规范的沟通文本。
- 团队负责人需要每周提交 Progress/Plans/Problems 格式的 3P 更新,希望统一团队汇报格式。
- 内部沟通专员撰写全公司范围的新闻通讯,需要保持一致的语气和版式。
- 工程团队在事故后撰写事故报告,希望有现成的结构化模板指引。
- 项目经理发布项目状态更新或领导层汇报,希望快速按公司惯例成稿。
- 支持或运营人员需要答复常见问题(FAQ),希望回答口径一致。
这个 Skill 有哪些优点和局限?
- 覆盖 7 种常见内部沟通场景,包括较为标准化的 3P 更新结构。
- 纯指令型技能,无脚本依赖,跨平台和跨模型的可移植性好。
- 设有兜底指南(general-comms.md),未匹配类型时会主动向用户澄清而非臆测格式。
- 随仓库提供 MIT 许可与维护中的安装、升级流程。
- 无示例指南文件的具体内容可查,格式质量难以预先评估。
- 指南内容反映'我的公司'的格式偏好,未必适配其他组织的内部规范。
- 缺乏专门的技能级测试;仓库测试针对 Agent 核心功能而非各技能输出质量。
- 技能级别无独立版本或变更记录,维护信息只在仓库整体层面。
如何安装这个 Skill?
该技能随 Mini-Agent 仓库整体分发。快速安装:uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git,然后运行官方 setup 脚本生成配置,并在 ~/.mini-agent/config/config.yaml 填入 MiniMax API Key 和 API Base。开发模式:git clone 仓库后执行 uv sync,并运行 git submodule update --init --recursive 初始化技能目录。技能位于 mini_agent/skills/internal-comms/;将单个技能文件夹放入其他 Agent Skills 兼容客户端的技能目录这一做法在源文档中未说明。
如何使用这个 Skill?
在 Mini-Agent 中直接提出内部沟通类请求即可触发,例如:"帮我写一份本周的 3P 更新"或"为这次服务中断写一份事故报告"。技能会识别沟通类型、加载 examples/ 下对应的指南文件,并按指南格式输出。如果类型无法匹配现有指南,它会向你询问目标格式或更多上下文。