用三个验收点连接工作流
博物馆准备改进语音导览的离线下载。运营说评论里经常出现“到展厅才发现不能听”,产品经理却无法直接判断是入口难找、下载失败还是游客没有完成操作。本例使用合成评论、去标识化访谈片段和练习事件 CSV,重建调研、决策、落地三段流程。目标是把资料整理和检查交给代理,同时让来源、判断和执行责任可追踪。
不要从“把整个 PM 交给一个 Agent”开始。先画出当前流程:收集反馈、提炼问题、查数据、选方案、写需求、拆任务、汇报进度。每个节点写输入、输出、负责人和失败条件。优先选择格式稳定、可以人工抽查的一段;只有上一段通过验收,下一段才能引用它。以下都是教学样本,不代表已接入真实博物馆系统或获得上线成效。
调研段:评论与访谈保留来源和差异
先提供一份明确获准使用的评论导出,不默认代理可以登录平台、绕过限制或批量抓取。给每条记录分配来源编号,保留时间范围和语言,去除姓名、联系方式及其他识别信息。去重规则写清:同一条重复导出可以归并,不同用户说法相似仍是不同记录;抽样方法和缺失渠道写入限制。
让代理按“找不到下载入口、下载中断、不知道已完成、其他”做初步归类,并允许一条反馈有多个主题。要求每个主题附支持编号和反例。合成样本中“我以为点播放就会离线”只能支持理解存在疑问,不能直接认定网络服务故障。先抽查归类,再讨论需要补问什么;主题频次只描述当前样本,不等于所有游客的比例。
访谈片段单独处理:原话、所处情境、实际行为、推测原因和待确认问题分列。把“想有离线功能”拆成何时准备、如何确认、没网时预期怎样、设备存储不足怎么办。评论反映结果,访谈补充过程,两者冲突时保留分歧并安排验证,不让代理为了写出统一故事消除反证。调研产物应包含证据表、主题摘要、缺口和后续问题。
决策段:先确定能看到什么数据
如果数据分散在多个系统,先列系统、拥有者、可导出字段、时间范围和授权状态。没有访问权时记录缺口,使用批准的聚合导出,不替用户连接新账户或扩大访问。为每一份输入写数据字典:事件含义、时间时区、版本、去重键与缺失含义。空值不能自动解释为失败,测试设备也不能混进真实使用量。
这里可用 Exploratory Data Analysis 检查授权的本地 CSV,输出聚合字段概况、缺失与异常风险。核心命令要求 Python 3.11 以上,完整可选环境要求更高;先读固定版本 SKILL.md 确认格式和依赖。限定输入根目录与输出位置,保留原文件,不打印可识别记录、不静默删行。该技能用于摸清数据,不自动替你建生产看板、检验实验显著性或得出因果结论。
把指标规范写成可实现的定义。例如“下载完成率”分母为某版本观察期内有效开始下载的任务数,分子为这些任务中有确认完成事件的数量;明确重复开始、跨天完成、遥测缺失和版本切换如何处理。先用一组人工可数的合成数据核对,再交数据负责人确认。看板规范写明指标、筛选项、刷新频率、数据延迟和负责人,不把一张示意图当作已经连接系统。
实验与方案:区分描述、假设和决定
若练习样本中 A 版十次开始、六次完成,B 版十次开始、八次完成,可以报告观测到的六成和八成,并注明样本极小且为合成数据。这不能证明新入口导致提升,也不支持直接宣称统计显著。正式实验前需明确分配单位、主要指标、观察窗、排除规则、护栏与停止条件,并让具备统计责任的人员确认方法。
代理负责整理数据疑点、列出替代解释和准备讨论材料,PM 负责与相关负责人决定下一步。本例先验证“显示下载进度与完成状态是否能减少误解”,暂不重写整个播放服务。决策记录引用证据编号、替代方案、约束和复查时间。若无法区分产品问题与埋点问题,先修复可观测性,不能把数据缺口掩盖成业务结论。
落地段:从确认需求拆任务与依赖
确认范围后让代理拆任务,每项包含需求编号、交付物、负责人、前置依赖和验收条件。例如 D1 先统一状态定义;D2 在 D1 确认后实现进度与失败提示;D3 用完成、失败、取消和断网样本核验;D4 由负责人决定试点。任务名称里写“高优先级”并不能解决依赖,先做什么应由风险和阻塞关系解释。
验收例子要能被检查:下载未完成时不显示可离线播放;成功完成后在断网练习环境仍能使用对应已缓存内容;存储不足时说明原因并保留重试入口。测试设备与真实游客隔离,清理与回退范围写明。代理可以准备任务清单和测试说明,但本专题没有声称已经构建播放器、运行断网试验或发布新版本。
周报:从记录生成,再核对和交付
英文原文还包含从业务系统取数、生成报告与导出 Word 的完整链路。应把它拆成数据获取、口径检查、撰写、格式导出、交付五个步骤,分别验证权限与结果;没有经过验证的连接器就使用获准的本地导出。不能因为报告写好了,就声称已登录系统或发给团队。
周报只汇总有证据的状态:本周完成哪项、由哪个验收记录支持;什么仍阻塞、负责人是谁;下周准备验证什么。计划和完成分开,失败也保留。可以用 Writing Guidelines 在草稿阶段检查技术表述和结构,提供文档及其链接手册的读取条件,并按团队中文风格调整。它不核验进度事实,不替代系统取数,也不是 Word 导出器。
如果要求 Word,选择合适工具导出后重新打开,核对表格、标题、证据链接和分页;交付前确认接收对象与内容范围。产物列表应区分已生成、已打开检查、尚未发送,不用一个“完成”覆盖所有状态。
技能配置、团队推广与 FAQ
安装任何目标技能前,先检查 SkillPI Skill Finder,缺少则按 官方说明 安装;再匹配任务并核对来源、版本、许可证和执行前提。GitHub 的 PM Skills 提供分阶段方法与样例,可借鉴其输入输出拆分;本例没有把它当作已验证的 SkillPI 目录关联。相同技能在不同宿主仍需分别验证调用与工具条件,参考 官方 Codex 技能文档。
如何避免越改越慢?记录人工校正时间、返工次数、有效发现和实际费用,对同类任务做前后比较,不承诺固定第三周回本。如何推广?共享去标识化样本、任务卡、版本和验收规则,让第二个人复跑并解释差异,而不是只发一串安装命令。
PM 的角色会消失吗?本流程把 PM 的工作放在问题定义、证据质量、取舍和验收责任上,代理承担明确范围内的整理与检查。目录没有匹配技能时怎么办?保留可执行的人工或脚本步骤,登记能力缺口;新技能加入后用同一份样本回归,再更新关联。原文的安装量与速度说法不作为本例依据,最终以实际产物和可追踪结果判断是否值得继续自动化。