用 internal-comms 技能撰写 3P 周报：Progress、Plans、Problems 更新格式的完整实战指南

用 internal-comms 技能撰写 3P 周报Progress、Plans、Problems 更新格式的完整实战指南【免费下载链接】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 技能 及其核心示例 3p-updates.md写出专业、简洁、面向管理层的 3P 周报Progress、Plans、Problems。读完本文你将掌握 3P 更新的定义与适用场景、三段的写作要点、信息收集的时间窗口与工具来源、严格的标准格式模板以及一套可直接照做的四步工作流。什么是 3P 更新写给没太多上下文的读者3P 更新全称是Progress, Plans, Problems是内部沟通中非常流行的一种团队状态汇报格式。它的核心定位是面向高管、管理层和其他同事读者对团队工作只有一定了解但不需要知道每个技术细节极致简短目标是让读者在3060 秒内读完强调事实以数据驱动用指标说话而不是堆砌过程描述。3P 更新可以覆盖任意规模的团队大到整个公司都可以使用。规模越大任务颗粒度越粗。例如一个移动团队的 3P 可能写上线了某功能或修复了若干 bug而公司层面的 3P 则会写新招 20 人或新签 10 个客户这样更厚重的成果。从技能结构看这份示例位于 internal-comms/examples/3p-updates.md是 internal-comms/SKILL.md 中定义的四种内部沟通示例之一。当需要写状态汇报、领导层更新、3P 周报时SKILL.md 会要求加载这份示例文件并严格遵循其中的格式、语气与信息收集指引。三个核心段落Progress、Plans、Problems一份 3P 更新代表团队在某个时间段几乎总是一周内的工作包含三个固定段落段落含义写什么Progress过去时间段的成果重点写已发布的功能、达成的里程碑、创建的任务等Plans下一时间段要做的事重点写团队最关注、优先级最高的事项Problems拖慢团队的事情如人手不足、阻碍进展的 bug 或 blocker、谈崩的客户等写作时要注意时间导向Progress覆盖一周前到今天之间发生的事Plans覆盖今天到下一周的计划Problems同样聚焦一周前到今天之间出现的问题。写之前先确认两件事动笔之前必须确认两个前提团队名称如果用户没有明确给出团队名应当主动询问你要我为哪个团队写这份更新时间段通常 Progress/Problems 覆盖过去一周Plans 覆盖接下来一周如有特殊时间段需与用户确认。这一步对应下方工作流中的澄清范围是整个流程的第一步避免写出来的更新缺乏归属或时间错位。信息收集优先从现有工具抓取而不是凭空编造文档明确要求尽可能从可用来源拉取信息而不是凭记忆或想象写作。推荐的来源与优先级如下Slack团队成员发布的更新帖优先找大频道里、有很多 reactions 的帖子Google Drive核心成员撰写的高浏览量文档Email回复多、内容量大且与主题相关的邮件Calendar重要的非重复会议如产品评审product review等。如果当前环境没有这些工具的访问权限可以直接询问用户希望覆盖哪些内容用户也可能直接把素材给你此时你的主要工作就是把这些素材整理成规定的格式。四步工作流从澄清到定稿文档给出了清晰的四步流程澄清范围Clarify scope确认团队名称和时间段通常 Progress/Problems 为过去一周Plans 为下一周收集信息Gather information使用可用工具获取素材或直接向用户提问起草更新Draft the update严格按照下文的标准格式编写复核Review确保全文能在 3060 秒内读完且是数据驱动的。这套工作流与 internal-comms/SKILL.md 中识别沟通类型 → 加载对应示例文件 → 遵循文件中的格式与语气指引的整体机制一致先判断沟通类型再套用对应模板最后按模板约束产出。标准格式严格、统一、不自由发挥3P 更新的格式是固定的、非常严格的文档强调除了这种格式不要使用任何其他格式。完整模板如下[选一个 emoji] [团队名称] (覆盖日期通常是一周) Progress: [1-3 句话] Plans: [1-3 句话] Problems: [1-3 句话]逐项拆解格式要求emoji选一个有趣、能体现团队氛围和本期更新气质的 emoji团队名称与日期紧跟 emoji 之后日期通常是一周范围三个段落每个段落不超过 13 句话清晰直接数据驱动尽量包含指标metrics用数据支撑结论语气非常就事论事matter-of-fact避免过度铺陈的散文式表达。完整示例假设你要为移动团队写本周更新可以写成:rocket: Mobile Team (Sep 7 – Sep 13) Progress: Shipped push notification v2 to 100% of users. Cut crash rate from 1.2% to 0.4%. Created 12 new tasks for the onboarding revamp. Plans: Roll out the onboarding revamp to 10% of users for A/B testing. Begin refactoring the sync engine. Problems: Short-staffed — two engineers out this week, blocking the sync refactor timeline.对照要求逐条检查emoji 契合发布、前进的氛围每段 12 句话都包含具体数据100%、1.2%→0.4%、12 个任务、10%、两人缺勤语气平实直接无修辞堆砌。常见误区与写作自检清单基于文档的约束写作时注意规避以下问题每段超过 3 句超出即违反格式需要精简过度细节化把实现细节写进更新会导致读者无法在 3060 秒内读完大团队尤其要减少颗粒度没有指标纯定性描述会削弱数据驱动的要求能给出数字的尽量给数字语气过于文学化3P 追求就事论事避免散文式的铺垫与渲染时间窗口错位Progress/Problems 写的是过去一周Plans 写的是下一周不要混用团队名缺失动笔前必须确认团队名称否则标题无法成立。在仓库中的定位与延伸阅读internal-comms/SKILL.md技能入口定义何时使用该技能、如何加载示例文件以及关键词3P updates、weekly update 等internal-comms/examples/3p-updates.md本文核心依据3P 更新的完整规范internal-comms/examples/company-newsletter.md公司级新闻通讯格式与 3P 互补3P 面向团队新闻通讯面向全公司internal-comms/examples/faq-answers.md全公司常见问题汇总与回答的格式规范internal-comms/examples/general-comms.md不匹配上述三种类型的通用内部沟通准则internal-comms/LICENSE.txt技能与示例采用 Apache License 2.0 授权README.md仓库总览中对该技能的定位说明Craft internal announcements, updates, and stakeholder messaging。需要特别说明的是3P 更新是 internal-comms 技能下与公司新闻通讯、FAQ 并列的一种独立沟通类型新闻通讯面向全公司、约 2025 条要点FAQ 面向全公司高频疑问而 3P 更新聚焦单一团队的一周进展。三者共享从 Slack/Email/Calendar/Documents 抓取素材、以数据驱动、简短清晰的原则但格式与颗粒度各不相同写作时应先确认类型再套用对应模板。【免费下载链接】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），仅供参考