awesome-codex-skills 之 internal-comms:用 Codex Skill 自动生成 3P 周报、公司通讯、FAQ 与事故报告的完整指南 📅 发布时间:2026/9/16 11:54:48 👁 浏览次数: awesome-codex-skills 之 internal-comms用 Codex Skill 自动生成 3P 周报、公司通讯、FAQ 与事故报告的完整指南【免费下载链接】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技能展开讲解如何让 Codex/Claude 按照你所在公司既有的沟通习惯与格式自动撰写各类内部沟通文档覆盖 3P 周报Progress/Plans/Problems、公司通讯Newsletter、FAQ 答复、状态报告、领导层更新、项目更新与事故报告等高频场景。读完本文你将掌握该技能的元数据触发机制、四级渐进式披露的目录结构、四种沟通格式的严格排版规范以及如何结合 skill-installer 把它安装进$CODEX_HOME/skills并在 Codex 会话中按需触发。一、技能定位什么是 internal-commsinternal-comms是 awesome-codex-skills 仓库生产力与协作Productivity Collaboration分类下的一项 Codex Skill定位为Craft internal announcements, updates, and stakeholder messaging撰写内部公告、更新与利益相关方沟通信息。它位于仓库的 internal-comms/ 目录许可证为 Apache License 2.0完整条款见 internal-comms/LICENSE.txt。与仓库中同属沟通与写作方向的 email-draft-polish邮件润色、content-research-writer带引用的内容写作不同internal-comms 的核心价值在于格式一致性与组织语境适配它不追求通用写作技巧而是让 Agent 严格按照你所在公司喜欢使用的格式来产出内部沟通内容从而保证 AI 生成物与企业既有模板、语气、信息密度保持一致。1.1 Frontmatter 元数据触发机制的关键internal-comms/SKILL.md的 YAML frontmatter 定义了该技能的元数据这是 Codex 决定何时加载技能的入口--- name: internal-comms description: A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.). license: Complete terms in LICENSE.txt ---根据 README.md 对 Codex Skills 机制的说明技能存放在$CODEX_HOME/skills默认~/.codex/skills下每个子目录需包含带name与descriptionfrontmatter 的SKILL.md在会话中自然描述任务时Codex 会依据description与请求的匹配度自动触发对应技能。因此internal-comms的description字段特意枚举了状态报告status reports、领导层更新leadership updates、3P 更新、公司通讯、FAQ、事故报告incident reports、项目更新project updates等全部触发场景确保语义匹配时不遗漏。二、何时使用该技能When to useinternal-comms/SKILL.md明确列出该技能的适用场景清单3P 更新Progress, Plans, Problems即进展 / 计划 / 问题团队周报公司通讯Company newslettersFAQ 答复FAQ responses状态报告Status reports领导层更新Leadership updates项目更新Project updates事故报告Incident reports任何属于上述类型的内部沟通请求都应当触发该技能。核心设计意图是凡是写给公司内部受众、且需要遵循固定格式的文本都交给这个技能统一处理避免每次由 Agent 自由发挥导致格式漂移。三、如何使用四级渐进式披露目录结构该技能的使用流程在 internal-comms/SKILL.md 中描述得非常清晰整体是一个识别类型 → 加载对应指南 → 遵循指南执行的管线识别沟通类型从用户请求中判断属于上述哪一类内部沟通。加载对应的指南文件从examples/目录读取与类型匹配的指南文件internal-comms/examples/3p-updates.md — 用于 Progress/Plans/Problems 团队更新internal-comms/examples/company-newsletter.md — 用于公司全员通讯internal-comms/examples/faq-answers.md — 用于回答常见问题internal-comms/examples/general-comms.md — 用于不匹配以上任何类别的其他内部沟通遵循指南中的格式、语气与内容收集要求执行写作。若沟通类型与现有指南均不匹配则向用户询问澄清或获取关于期望格式的更多上下文。这一结构与 README.md 描述的 Codex Skills 最佳实践——渐进式披露progressive disclosure把详细参考材料放在references/本技能中为examples/目录中仅在需要时从SKILL.md加载——完全一致主文件保持精简避免占用上下文窗口详细格式规范按需懒加载。这正是该技能上下文高效的关键设计。四、核心格式详解一3P 更新Progress/Plans/Problems3P 更新是该技能最有特色的场景完整指南见 internal-comms/examples/3p-updates.md要点如下。4.1 受众与定位3P 更新面向高管、领导层、其他团队成员等对团队工作有一定了解但不多的受众要求极其简洁、直击要点理想状态是 30~60 秒内读完。它不是散文而是数据驱动的事实陈述。4.2 粒度缩放原则3P 可以覆盖任意规模的团队直至整个公司。团队越大条目越粗粒度小团队如移动端团队可以写发布了某功能修复了若干 bug公司级 3P 则写更有分量的内容如新招 20 人新签 10 个合同。4.3 三段落结构3P 代表团队在一个时间段内的工作几乎总是按周划分包含三个部分Progress进展团队在该时间段内完成了什么聚焦已发布的内容、达成的里程碑、创建的任务等。Plans计划团队计划在下一时间段做什么聚焦最紧要、优先级最高的事项。Problems问题拖慢团队进度的任何因素例如人手不足、阻碍前进的 bug 或阻塞项、谈崩的交易等。4.4 信息收集工具与时间窗口写作前应尽可能从可用来源收集信息指南明确建议优先使用 Slack、Google Drive、Email、Calendar 等渠道Slack团队成员的更新帖优先选择大频道中互动reaction多的帖子Google Drive关键成员撰写、浏览量大lots of views的文档Email回复多、内容丰富且相关的邮件Calendar产品评审等非周期性、重要性高的会议。时间窗口的界定非常明确Progress一周前到今天之间的内容Plans今天到接下来一周的内容Problems一周前到今天之间的内容。若没有工具访问权限可让用户直接提供想覆盖的内容当用户直接给出素材时Agent 主要工作就是按本格式排版。写前必须确认团队名称若未指定应主动询问。4.5 严格排版格式指南强调排版始终固定、极其严格不允许使用任何其他格式[选择一个贴合团队氛围与更新内容的 emoji] [团队名称]覆盖日期通常为一周 Progress: [1-3 句内容] Plans: [1-3 句内容] Problems: [1-3 句内容]每段不超过 1~3 句清晰直接内容数据驱动尽量包含指标语气就事论事避免过度修饰的散文腔。4.6 写作工作流澄清范围确认团队名称与时间段通常 Progress/Problems 取上周Plans 取下周收集信息使用可用工具或直接询问用户起草更新严格遵循上述排版格式评审确保 30~60 秒可读完且数据驱动。五、核心格式详解二公司通讯Company Newsletter完整指南见 internal-comms/examples/company-newsletter.md。5.1 目标与约束公司通讯用于总结公司过去一周/一个月的情况面向全员阅读通常约 20~25 条 bullet points通过 Slack 与 Email 分发因此必须对这些渠道友好、易消化。5.2 期望属性大量链接引用高度相关的 Google Drive 文档、公告频道中高热度 Slack 消息与高管发言、全公司范围的邮件以及公司内发生的重要事件短小精悍每条 bullet 不超过 1~2 句用we口吻因为写作人也是公司一员多数条目应写成we did this / we did that。5.3 工具与内容来源与 3P 类似尽量使用 Slack人多、reaction 多或 thread 内回复多的频道消息、Email高管的全公司公告、Calendar如 All-Hands 等大参会人数的会议及其附件文档、Documents近一两周内新发布、关注度高的文档如公司愿景文档、下季度/下半年计划、关键高管撰写的文档以及外部媒体对公司的报道。无权限时可让用户提供素材此时主要工作是润色与套用格式。5.4 分节与优先级由于公司规模大指南示例为 1000 人、团队与项目众多建议将更新按主题分节例如 {产品研发、市场推广、财务}、{招聘、执行、愿景} 或 {外部新闻、内部新闻}确保公司各领域都被覆盖。优先级上聚焦全公司范围的影响而非团队级细节领导层公告重大里程碑与成就影响多数员工的信息外部认可或媒体报道。避免过于细碎的团队更新那是 3P 的职责只对少数群体相关的信息已经沟通过的信息避免重复。5.5 示例格式骨架指南给出的结构示范如下emoji 图标用于区分板块: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 :pillar: Leadership Updates - Post 1 - Post 2 - Post 3 :thread: Social Updates - Update 1 - Update 2 - Update 3六、核心格式详解三FAQ 答复完整指南见 internal-comms/examples/faq-answers.md。6.1 使命FAQ 场景中Agent 扮演公司知识汇总助手每周公司内会产生大量问题Agent 的职责只有两件事——找出让大量员工困惑的问题来源通常是影响大部分员工的事情并给出精炼的总结性回答以消除困惑。选题示例包括近期公司事件融资、新高管等、即将上线的产品、招聘进展、愿景或重心变化等。6.2 信息源使用公司常用的协作工具Slack回复多的帖子下的问题、reaction 或点赞多的问题说明大量员工有同样疑问、Email直接含 FAQ 的邮件、Documents挂在日历事件上的 Google Drive 文档可从中直接提取或推断 FAQ。6.3 排版与指南排版保持基础朴素- *Question*: [插入问题 - 1 句] - *Answer*: [插入答案 - 1-2 句]回答指南尽量基于官方沟通内容作答信息不确定时明确说明链接到权威来源文档、公告、邮件保持专业但平易近人的语气若问题需要高管输入或官方答复应标记出来。同时要求保持全局视角不要只聚焦提出问题的某个人或其所在团队而应尽量覆盖整个公司让回答对全员都有参考价值。七、核心格式详解四通用内部沟通General Comms完整指南见 internal-comms/examples/general-comms.md。当沟通需求不属于 3P、通讯或 FAQ 任一标准格式时走此通道。动笔前必须先澄清四项前提询问目标受众target audience理解沟通目的purpose澄清期望的语气formal / casual / urgent / informational确认是否有特定格式要求。通用写作原则清晰简洁使用主动语态最重要的信息放在最前面包含相关链接与引用匹配公司的沟通风格。这保证了非标沟通也能在充分澄清后产出符合组织习惯的内容而不是由 Agent 自行假设。八、安装与触发把 internal-comms 接入 Codex8.1 推荐方式Skill Installer仓库推荐通过 skill-installer 脚本安装技能。在已克隆仓库的前提下git clone https://github.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills # 安装 internal-comms 到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path internal-comms根据 skill-installer/SKILL.md 的行为说明脚本默认对公开仓库采用直接下载方式下载失败认证/权限错误时回退到 git sparse checkout若目标技能目录已存在则中止安装位置为$CODEX_HOME/skills/skill-name默认~/.codex/skills可多次传--path一次安装多个技能支持--ref默认main、--dest、--method auto|download|git等选项。安装完成后重启 Codex以加载新技能元数据。8.2 手动安装将internal-comms/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 使其加载新元数据在后续会话中自然描述任务如帮我写本周的 3P 更新Codex 会根据 frontmatter 中的description自动触发匹配的技能。8.3 验证与使用按 README.md 的说明验证安装ls ~/.codex/skills查看已安装技能列表head ~/.codex/skills/internal-comms/SKILL.md检查元数据是否正确加载。触发后技能会先读取 internal-comms/SKILL.md 的顶层指令再按类型懒加载examples/下对应的格式指南随后按指南执行澄清、收集素材、起草与评审。九、设计原理与最佳实践启示从源码结构看internal-comms 是 README.md 所倡导的 Codex Skill 最佳实践的典型示范触发描述力求穷尽description枚举全部适用沟通类型让自动触发更可靠渐进式披露控制上下文SKILL.md仅保留路由逻辑与关键词四个详细格式指南合计体量远超主文件全部放入examples/仅在对应类型触发时才加载避免无关格式规范浪费上下文窗口用脚本文档承载确定性步骤格式排版被写成强约束如 3P 的绝不使用任何其他格式降低 Agent 自由发挥导致的输出漂移明确的澄清边界团队名称未知时询问、工具无权限时请求用户提供素材、非标类型时澄清受众/目的/语气——把不确定性显式暴露给用户而非自行假设。如果你计划复用该技能或自行构建企业级沟通类技能可以直接以internal-comms/为模板主文件保持精简路由、把各公司专属模板放入独立参考目录、并在description中穷举触发场景。这正是该技能在 awesome-codex-skills 仓库中作为内部沟通自动化参考实现的价值所在。十、小结internal-comms以格式即规范为设计哲学通过四级渐进式披露结构将 3P 周报、公司通讯、FAQ 与通用沟通四类内部文档的格式约束固化为可复用的 Codex Skill主文件负责类型路由与触发examples/目录承载详细的排版、语气、信息收集与工具使用指南。配合 skill-installer 一键安装后Codex 即可在会话中按描述自动触发显著降低撰写内部沟通文档时反复澄清格式的成本让 AI 生成内容始终贴合公司既有沟通习惯。【免费下载链接】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),仅供参考