ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

3P 更新实战指南:基于 Agent Skills internal-comms 技能编写 Progress / Plans / Problems 团队周报

3P 更新实战指南:基于 Agent Skills internal-comms 技能编写 Progress / Plans / Problems 团队周报 人工智能AI 技能AI 评测【免费下载链接】skillsPublic repository for Agent Skills项目地址https://gitcode.com/GitHub_Trending/skills3/skills点击查看免费下载3P 更新Progress / Plans / Problems是团队向管理层与跨职能同事同步进展的标准沟通格式目标是让读者在 3060 秒内掌握团队的全貌。本文以本仓库 internal-comms 技能中的 3P 更新指南 为骨架结合技能的整体设计系统讲解 3P 更新的受众定位、三板块写作要点、信息收集渠道、标准工作流程与严格格式规范并给出可直接套用的示例模板与常见误区帮助你在被要求编写周报、状态更新或领导层汇报时让 Agent 一次产出符合公司惯例的高质量内容。一、什么是 3P 更新3P 更新代表Progress进展、Plans计划、Problems问题是内部沟通中一种高度结构化的状态汇报格式其核心受众包括高管、领导层以及其他团队成员。它的设计初衷决定了它的两个基本特征极度简洁、直击要点整个更新应能在3060 秒甚至更短的时间内读完。读者不是来细读报告的而是快速获取团队当前的状态信号。面向有部分上下文但不多的读者3P 更新的读者了解公司大致背景但对具体团队每天在做什么并不清楚。因此内容必须自解释不能依赖读者掌握团队内部术语或历史细节。在 internal-comms 技能的定位中3P 更新是每次被要求编写内部沟通内容状态报告、领导层更新、3P 更新、公司新闻通讯、FAQ、事故报告、项目更新等时最常命中的格式之一。技能要求先判断沟通类型再加载examples/目录下对应的指南文件其中examples/3p-updates.md用于 Progress / Plans / Problems 团队更新examples/company-newsletter.md用于全公司范围的新闻通讯examples/faq-answers.md用于回答高频员工提问examples/general-comms.md用于不匹配上述任何一类的内容。二、适用范围与任务颗粒度3P 更新可以覆盖任何规模的团队范围上至整个公司。颗粒度随团队规模增大而变粗这是选择素材最重要的原则小团队如移动端团队任务颗粒度较细可以写发布了某个功能修复了某些 Bug这类具体事项大团队或全公司3P 更新应有重量感例如新招聘 20 人新签下 10 单这类宏观里程碑。写作时应依据团队规模调整素材的抽象层级避免用全公司的视角罗列小组级别的琐碎任务也避免用小团队的细致视角汇报宏观战略——二者都违背 3P 更新快速传达关键状态的初衷。3P 更新代表团队在一个时间段内的工作这个时间段几乎总是一周。文档中明确说明其包含三个板块各板块的语义如下Progress进展团队在上一个时间段内完成的工作。重点放在已发布的内容、达成的里程碑、创建的任务等确定性成果而非正在做的事Plans计划团队计划在下一个时间段内要做的事。重点放在当前最受关注、优先级最高的事项上Problems问题一切拖慢团队进度的因素。例如人手不足、阻碍前进的 Bug 或阻塞项、谈崩的交易等。三、三大板块的写作要点Progress只写已完成Progress 的核心是成果而非过程。筛选素材时优先选择已发布的功能或版本shipped feature达成的里程碑milestone achieved已创建/已关闭的任务tasks created / closed可量化的改进如崩溃率、构建时长、转化率的改善。一个可以对照的粒度示例是移动端团队的 Progress 是发布 v2.3含推送通知修复上周报告的 14 个 Bug。Plans聚焦高优先级Plans 回答接下来最重要的几件事是什么。写作时只列当前真正优先的事项不要展开完整的季度路线图通常给出下个时间窗口内会落地的事情例如下周灰度测试新的引导流程 A/B 实验与 Progress 形成时间上的接续关系——上一个周期完成什么下一个周期接着做什么。Problems诚实呈现阻塞Problems 是 3P 更新中信息价值最高的板块也是管理者最关注的部分。常见内容人力瓶颈如团队本周有两位工程师休假QA 周期被拉长技术阻塞如等待安全评审数据导出功能无法按期上线业务挫折如某笔关键交易未谈成。写作时无需美化但要简洁陈述事实与影响让读者能判断是否需要介入支持。四、写作前的信息收集从哪里获取素材原文档强调只要有可能就应主动从可用的数据源拉取所需信息而不是凭空臆造。推荐的来源包括Slack团队成员发布的更新帖优先关注**大频道中反响热烈大量 reaction**的帖子Google Drive关键成员撰写的文档优先关注浏览量大的文档Email回复多、内容相关度高的邮件Calendar非周期性、重要度高的会议例如产品评审product review等。信息收集要尽量全面并紧扣你所撰写的时间段Progress覆盖一周前到今天之间发生的事Plans覆盖今天到下周之间打算做的事Problems覆盖一周前到今天之间出现的阻碍。如果 Agent 没有访问上述工具的权限可以直接向用户询问希望覆盖的内容如果用户直接把素材提供给你那么你主要的工作就变成按 3P 格式进行整理与排版而不是重新收集信息。五、标准工作流程原文档为 3P 更新的编写定义了四步工作流可以视为 Agent 执行任务的固定流程Clarify scope澄清范围确认团队名称与时间段。Progress / Problems 通常覆盖过去一周Plans 覆盖未来一周。写作前必须明确团队名称如果未指定应主动询问所撰写的团队名称Gather information收集信息优先使用可用的工具Slack、Google Drive、Email、Calendar获取素材无权限时向用户直接索取Draft the update起草更新严格遵循下述格式规范撰写正文Review审阅确认内容足够简洁3060 秒可读完且数据驱动。值得注意的是原文档在 Progress 的定义处写的是over the next time period结合第 6 行across a time period, almost always one week的总体定义以及工作流部分Progress/Problems 通常覆盖过去一周的明确说明可以推断此处为笔误实际应指上一个时间段撰写时以工作流部分的表述为准。六、严格格式规范与示例模板3P 更新的格式是固定的、严格的原文档要求绝不使用除此之外的任何其他格式。完整格式如下[选择一个贴合团队氛围且有趣的 emoji] [团队名称] (覆盖日期通常为一周) Progress: [1-3 句内容] Plans: [1-3 句内容] Problems: [1-3 句内容]关键约束逐条拆解标题行必须包含 emoji、团队名称和日期范围。emoji 的作用是有趣并能捕捉团队与更新的氛围例如传达活力、专注或紧张状态每个板块不超过 13 句清晰、直击要点杜绝冗长的段落式叙述数据驱动尽量在句子中融入指标例如发布的功能数量、修复的 Bug 数、达成里程碑的比例等语气就事论事matter-of-fact避免过度修饰的散文式文风。下面是一个符合全部规范的示例含指标、简洁、就事论事:rocket: Mobile Team (Aug 12 – Aug 18) Progress: Shipped v2.3 with push notifications; fixed 14 bugs reported last week; crash-free rate now at 99.4%. Plans: Roll out A/B test on onboarding flow; finish backend migration for the new payment API. Problems: Two engineers on PTO this week is slowing the QA cycle; awaiting security review on the data export feature.对照这个示例检查你的草稿能否在 60 秒内读完每句话是否都携带了可验证的事实或数据是否省略了读者不需要的团队内部细节——三点均满足才算合格的 3P 更新。七、3P 更新与其他内部沟通格式的分工在 internal-comms 技能中3P 更新只是众多内部沟通格式之一理解它与相邻格式的分工有助于在编写时做出正确的素材取舍沟通格式适用场景与 3P 更新的主要区别3P 更新团队周期通常一周状态同步三个板块、每板块 13 句面向管理层公司新闻通讯全公司月度/周度综述约 2025 条要点多用we语气按主题分板块强调链接与公司级影响FAQ 回答汇总并回答员工高频困惑采用问题 12 句答案的问答结构通用内部沟通不匹配上述格式的其他沟通先澄清受众、目的、语气与格式要求例如公司新闻通讯指南 明确要求避免过于细粒度的团队更新这些留给 3P 更新——这从侧面印证了 3P 更新是团队粒度信息的主阵地而新闻通讯负责公司级信息的聚合与扩散。当你拿到的需求是给某个团队写周报时应使用 3P 格式当需求是写给全公司看时则切换到新闻通讯格式。八、Agent 如何按技能机制使用本指南在实际使用中该指南通过 internal-comms 技能被加载。技能的使用方式如下触发当 Claude 被要求编写内部沟通内容3P 更新、新闻通讯、FAQ 回复、状态报告、领导层更新、项目更新、事故报告等时技能被激活判断类型从请求中识别沟通类型加载对应指南从examples/目录加载匹配的指南文件3P 更新对应加载examples/3p-updates.md按指南执行遵循该文件的格式、语气与信息收集指引完成写作。若沟通类型与现有指南均不匹配技能要求向用户询问澄清或补充更多上下文。整个 internal-comms 目录即为该技能的完整资产技能元数据frontmatter 中的 name、description、license定义了其适用场景examples/下的四个指南文件分别承载不同格式的写作规范。对于 3P 更新而言最核心的执行依据就是本文所讲解的 3p-updates.md 中的定义、时间范围、工作流与格式约束。九、快速自检清单最终交付前对照原文档要点完成以下自检格式标题行是否包含 emoji、团队名称、日期范围三个板块是否均为 13 句时长整体是否能在 3060 秒内读完数据每板块是否尽可能包含指标与可验证事实颗粒度任务描述是否与团队规模匹配大团队粗粒度、小团队细粒度时间窗口Progress / Problems 是否聚焦过去一周Plans 是否聚焦未来一周语气是否就事论事、无冗余修饰只要上述条目全部通过你产出的 3P 更新即可直接用于管理周会、领导层同步与跨团队信息共享。赞分享人工智能AI 技能AI 评测【免费下载链接】skillsPublic repository for Agent Skills项目地址https://gitcode.com/GitHub_Trending/skills3/skills点击查看免费下载相关推荐用 internal-comms 技能撰写 3P 周报Progress、Plans、Problems 更新格式的完整实战指南用 internal comms 技能撰写 3P 周报Progress、Plans、Problems 更新格式的完整实战指南 本文是一份面向开发者与团队负责人AI 技能AI 插件工作流自动化人工智能基于 awesome-codex-skills 的 internal-comms 技能用 general-comms 指南撰写非标准内部通讯基于 awesome codex skills 的 internal comms 技能用 general comms 指南撰写非标准内部通讯 导读 企业内部沟AI 技能AI 插件工作流自动化人工智能基于 internal-comms 技能编写全公司新闻简报从信息收集到 Slack/邮件分发的完整指南基于 internal comms 技能编写全公司新闻简报从信息收集到 Slack/邮件分发的完整指南 导读 本文以 awesome codex skillsAI 技能AI 插件工作流自动化人工智能上一篇如何快速掌握Forza Mods AIO极限竞速地平线终极修改工具完整指南下一篇微信聊天记录永久保存终极指南免费开源工具完整备份方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表