基于 internal-comms 技能编写全公司新闻简报:从信息收集到 Slack/邮件分发的完整指南
【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills
导读
本文以 awesome-codex-skills 仓库中 internal-comms/examples/company-newsletter.md 为骨架,系统讲解如何用 Codex Skill 撰写一份高质量的全公司新闻简报(Company Newsletter)。你将掌握简报的篇幅与受众设定、三大内容特征、跨 Slack/邮件/日历/文档的信息采集策略、面向 1000+ 人公司的分节编排法,以及可直接套用的 emoji 分节模板,并理解这套规范在 internal-comms 技能中的组织方式与触发机制。
一、先明确定位:这份简报写给谁、写多长、从哪发
company-newsletter.md 开篇就给出了硬性约束,这是整份指南的“产品需求”:
- 篇幅:约 20~25 条 bullet points,不宜再多;
- 分发渠道:同时通过 Slack 和 Email 发送,因此内容必须“可消费”(consumable)——即一眼扫过去就能抓住重点;
- 受众:全体员工都会阅读,覆盖研发、市场、财务、人力等各个职能;
- 时间跨度:通常总结公司过去一周(或一个月)发生的、值得全体知晓的事情。
这几条约束决定了后续所有写作决策:既然是全员阅读,就必须筛掉团队内部的细枝末节;既然要跨 Slack/邮件分发,每条 bullet 就必须足够短、足够直白。
二、优秀简报的三大核心特征
原文档用三个特征概括了一篇合格的公司简报应该长什么样,写作时应作为逐条自检的标准:
信息密度高(Lots of links):大量链接。包括:
- Google Drive 上与公司高度相关的最新文档;
- announce 频道和来自高管的醒目 Slack 消息;
- 曾经发往全公司的邮件;
- 公司近期发生的重大事项的原文链接。
简而言之:简报是“索引”,不是“正文”。它负责把散落在各处的重要信息收敛到一处,读者点开链接即可深入。
短小精悍(Short and to-the-point):每条 bullet 控制在 1~2 句话以内,禁止长篇大论。这是 Slack/邮件场景下保证阅读完成率的关键。
使用“我们”的视角(Use the "we" tense):因为写作者本身就是公司的一员,绝大多数 bullet 应以“we did this / we did that”的口吻表述,让读者产生共同体的代入感,而不是旁观者的播报感。
三、信息收集:从五个信源挖掘“值得全公司知道”的内容
写好简报的前提是拿到足够多的素材。原文档按工具类型给出了明确的信息采集策略:
| 信源 | 采集要点 | 为什么值得收录 |
|---|---|---|
| Slack | 人数众多的频道、回复数多或 reactions 多的消息与线程 | 高互动即代表高关注度,通常是员工最关心的议题 |
| 高管发出的、讨论全公司范围公告的邮件 | 官方正式口径的第一手来源 | |
| Calendar | 参会人数多的大会,尤其是 All-Hands、大型公告类会议;会议附件中的文档是绝佳链接素材 | 全员大会是信息汇聚点 |
| Documents | 近一两周内新发布且获得大量关注的文档,如公司愿景文档、下季度/下半年规划、关键高管撰写的文档 | 方向性、战略性的内容值得全员对齐 |
| External press | 过去一周公司获得的媒体报道或文章引用 | 外部认可能提振士气,也适合放进简报 |
需要特别强调的是文档里的一个兜底策略:如果 Agent 没有接入上述任何工具,不要硬编内容,而是直接向用户询问本期想覆盖的话题——此时 Agent 的角色主要是把用户提供的素材按简报格式进行整理与润色。这体现了技能设计中“工具可用则用、不可用则降级为格式化助手”的务实思路。
四、面向 1000+ 人公司的分节编排策略
原文档假设公司规模较大(1000+ 人),这意味着每天并行推进的团队和项目非常多,一股脑罗列 20 条 bullet 会非常难读。因此必须按主题聚类分节,让不同职能的员工都能快速定位与自己相关的内容。
原文档给出的分节示例:
{product development, go to market, finance}—— 按业务职能分;{recruiting, execution, vision}—— 按工作性质分;{external news, internal news}—— 按信息来源分。
同时要求“尽量让公司不同板块都能被充分呈现”,避免简报变成单一团队(如研发)的独角戏。在分节时要注意颗粒度匹配:团队越大,任务颗粒度越粗——这条原则与同技能下 3p-updates.md 中的表述完全一致,可以互相印证。
五、优先级排序:该放什么、该砍什么
在素材多于篇幅时,原文档给出了一套明确的取舍规则:
优先放:
- 有全公司影响的内容(而非团队专属细节);
- 来自领导层的公告;
- 重大里程碑与成就;
- 影响大多数员工的信息;
- 外部的认可或媒体报道。
坚决避免:
- 过于细碎的团队更新(这类内容应放到各团队的 3P 更新中);
- 只对少数人相关的信息;
- 已经传达过的重复信息。
这套规则本质上是一个“影响面过滤器”:一条信息只有当它的受众足够广、价值足够大时才配得上简报的一个席位。团队内部的琐碎进展,交给 3p-updates.md 这类更细粒度的沟通载体去承载。
六、标准格式模板:直接套用的 emoji 分节示例
原文档末尾提供了完整的格式样例,这是最有直接复用价值的部分。每节用一个 emoji 打头作为视觉锚点,节内以无序列表罗列 bullet:
:megaphone: Company Announcements - Announcement 1 - Announcement 2 - Announcement 3 :dart: Progress on Priorities - Area 1 - Sub-area 1 - Sub-area 2 - Sub-area 3 - Area 2 - Sub-area 1 - Sub-area 2 - Sub-area 3 - Area 3 - Sub-area 1 - Sub-area 2 - Sub-area 3 :pillar: Leadership Updates - Post 1 - Post 2 - Post 3 :thread: Social Updates - Update 1 - Update 2 - Update 3从模板中可以看到两个细节:
- “Progress on Priorities”一节支持两级缩进:大方向(Area)下列出具体条目(Sub-area),适合承载“公司季度目标 → 各条线进展”这类结构化信息;
- 四个分节覆盖了完整的叙事弧线:公告(发生了什么)→ 进展(推进了什么)→ 领导层(谁在引领)→ 社交(员工生活与文化),正好回应了上文“让不同板块都被呈现”的要求。
七、技能实现视角:internal-comms 如何组织这套规范
从仓库源码结构看,这份公司简报指南并不是孤立的文档,而是 internal-comms 技能体系中专门负责“全公司新闻简报”的规范文件。查看 internal-comms/SKILL.md 可以还原整个技能的运作机制:
- 技能通过 YAML frontmatter 中的
name: internal-comms和description对外暴露触发条件——description明确写明“只要被要求撰写内部沟通材料(状态报告、领导层更新、3P 更新、公司简报、FAQ、事故报告、项目更新等)就应使用本技能”,Codex 据此在会话中自动匹配触发; - 技能的
examples/目录是一个规范库,按沟通类型路由到不同指南文件:- examples/3p-updates.md —— Progress/Plans/Problems 团队更新;
- examples/company-newsletter.md —— 全公司新闻简报(本文主题);
- examples/faq-answers.md —— 回答高频问题;
- examples/general-comms.md —— 其余无法归类的内部沟通。
- SKILL.md 还定义了一套使用流程:先识别沟通类型 → 加载对应指南文件 → 按其中的格式、语气与素材收集要求执行;若类型无法匹配,则向用户澄清或索取更多上下文。
这种“SKILL.md 负责路由、examples 负责规范、正文按需加载”的组织方式,正体现了 awesome-codex-skills 仓库 README 所提倡的**渐进式披露(progressive disclosure)**理念:技能元数据保持轻量,只有在触发后才加载对应的长文档,从而控制上下文开销。当你被要求写一份“全公司新闻简报”时,Codex 实际经历的就是:命中 internal-comms 的 description → 路由到 company-newsletter.md → 按其中的六大要素执行。
八、安装与使用:让 Codex 在会话中自动触发本技能
结合仓库 README 的安装说明,使用本技能有两种方式:
方式一:使用 skill-installer 安装(推荐)
git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path internal-comms安装脚本会把技能放到$CODEX_HOME/skills/(默认~/.codex/skills/),之后重启 Codex以加载新的技能元数据。
方式二:手动安装
- 将
internal-comms/目录复制到$CODEX_HOME/skills/(默认~/.codex/skills/); - 重启 Codex;
- 在会话中自然描述任务(如“帮我写一封本周的全公司新闻简报”),Codex 会根据 internal-comms/SKILL.md 的
description自动触发该技能。
触发后,Codex 会按上节所述流程路由到 examples/company-newsletter.md,并尝试调用 Slack、日历、文档等工具采集素材;若工具不可用,它会主动向你询问本期想覆盖的内容。你也可以通过ls ~/.codex/skills验证技能是否安装成功。
九、一份可直接执行的写作清单
将上述所有要点汇总成一次写作任务的执行清单,方便你在实际使用时对照:
- 定稿约束:确认目标为 20~25 条 bullet、Slack + Email 双渠道分发;
- 采集素材:优先从 Slack(高互动频道)、高管邮件、All-Hands 日历会议、高关注文档、外部媒体报道五个信源提取候选内容;无工具访问时直接向用户索取话题清单;
- 过滤信息:用“全公司影响面”标准做取舍,剔除团队细粒度更新与重复信息;
- 分节编排:按业务职能或信息来源聚类,如公告 / 优先事项进展 / 领导层动态 / 员工动态,确保各板块均衡呈现;
- 撰写与润色:每条 bullet 控制在 1~2 句,统一使用“we”视角,凡引用文档、消息、邮件处一律附链接;
- 按模板成稿:套用第六节的 emoji 分节格式,最终交付可直接粘贴进 Slack 频道与邮件客户端的成稿。
延伸阅读
- internal-comms/SKILL.md —— 技能的入口元数据、触发条件与使用流程
- internal-comms/examples/3p-updates.md —— 团队粒度更细的 Progress/Plans/Problems 更新规范,与公司简报互补
- internal-comms/examples/faq-answers.md —— 面向全员的高频问题答疑规范
- internal-comms/examples/general-comms.md —— 不匹配标准格式时的通用沟通准则
- README.md —— 仓库总览、技能安装与 Codex 触发机制的完整说明
【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考