Agent Skills 实战:把产品经理(PDM)常用产出写成 Skill(上)
Agent Skills 实战系列。本篇以 产品经理(PDM)常用产出为例:技能覆盖产品路线图、需求优先级/Backlog 排序、版本规划、竞品分析、产品汇报等文档类型,按团队模板生成或补全对应草稿,或对已有文档做符合性评审;与 PRD Skill 互补——PRD 定「单次需求做什么」,本篇侧重「排期、优先级、规划与汇报」。
本文里的 PDM (Product Manager)是为了给这类技能起一个便于区分的名字(为了跟后面要介绍的 PJM - Project Manager / Management 区分),指向的是产品经理相关的规划、优先级、汇报类文档, 还可以缩写成 PM;重点不在缩写本身,而在这组产出类型的统一模板化。
产品经理的日常产出很多:路线图、优先级说明、版本计划、竞品分析、周报……如果每个人的写法都不一样、关键项还经常缺失,团队在对齐、评审和复盘时就会很吃力。把这些常用模板收进一条 Agent Skill,价值就在于:当你说“写路线图”、“写版本规划”、“排一下需求优先级”、“写竞品分析”、“写产品周报”时,助手会尽量按同一套结构来组织内容,减少遗漏,降低沟通成本。
这一篇先把基础打牢,集中解决三个问题:
PDM Skill 到底该覆盖哪些文档类型。 SKILL.md应该怎么写。reference.md和可选scripts分别承担什么角色。
下一篇再继续看:这条 Skill 为什么适合先合并实现、如何从一句用户输入落到具体输出、以及上线后该如何验收和团队化使用。
一、从团队 PDM 文档规范到技能范围
先明确一件事:这条 Skill 到底负责“哪几类文档”,每一类又至少要写到什么程度。产品经理常用产出大致可以归纳为以下几类,每类都有相对稳定的必填项:
产品路线图(Roadmap):时间轴(季度/半年)、主题或目标、关键里程碑、依赖与风险、与战略对齐说明。 需求优先级 / Backlog 排序:优先级框架(如 RICE、MoSCoW)、排序结果列表(需求/ epic + 优先级 + 理由)、与目标对齐说明。 版本规划 / 发布计划:版本号与时间、版本目标、范围(需求/ epic 列表)、依赖与风险、发布节奏(如灰度)。 竞品分析:竞品列表、对比维度(功能/体验/定价等)、结论与产品行动建议。 产品汇报 / 周报:周期、核心指标与进展、阻塞与风险、下周重点、需决策项。
示例(可据团队裁剪):
这条 Skill 的目标很明确:当用户已经指明文档类型,并给出一组简要输入(例如“Q2 三个主题”“这批需求列表”“下个版本要上的功能”)时,助手应按对应模板生成一份可直接编辑的 Markdown 草稿;如果用户给的是已有路线图、版本规划或优先级说明,则输出符合性检查结果,给出必改项与建议项。
如果团队成员经常分不清“这件事到底该写成哪类文档”,可以先补一张选择表,把入口先统一起来:
适用边界与常见混淆
路线图 vs 版本规划:路线图回答“未来一段时间做什么方向”,强调阶段目标、主题和里程碑;版本规划回答“下个版本具体上什么”,强调版本目标、范围、时间和发布节奏。 需求优先级 vs 版本规划:需求优先级用于给候选需求排序,核心是“先做谁、为什么”;版本规划用于在某个发布窗口内确定范围,核心是“这次实际上哪些会上线”。 产品汇报 vs 项目周报:产品汇报强调业务目标、指标进展、风险和决策请求;项目周报更偏执行状态、任务推进与协作事项。若用户要的是研发执行视角,可能更适合项目周报类 Skill 或模板。 竞品分析 vs 市场调研:竞品分析更聚焦对手方案比较与我方动作建议;若目标是了解用户画像、市场规模、行业趋势,则应使用更偏研究类模板,而不是套用竞品分析结构。
如果仍然拿不准,可以先问用户一句:你要的是方向规划、版本落地、需求排序、竞品比较,还是对上汇报? 先把文档类型分清,再生成正文,通常比直接开写更稳。
如果你想先用一张图抓住这条 Skill 的范围与结构,可以先看下面这个简图:
二、SKILL.md 结构示例
在 .cursor/skills/pdm/ 下建 SKILL.md。推荐目录结构:
pdm/
├── SKILL.md
├── reference.md # 可选,各类型完整模板、优先级框架说明、示例
└── scripts/ # 可选,检查文档是否含必选节
└── check-pdm-sections.sh
下面这段可以直接作为第一版骨架:先把结构搭起来,再按你们团队的实际模板做删改。第一次看时不必逐字细抠,先重点抓三件事:description 如何覆盖常见表达、各文档类型的必填节如何定义、通用规范如何兜底。
示例 SKILL.md 如下:
---
name: pdm
description: 按团队模板生成或评审产品经理(PDM)常用文档,含产品路线图、需求优先级、版本规划、竞品分析、产品汇报等;适用于用户说“写路线图”、“写版本规划”、“排一下需求优先级”、“写竞品分析”、“写产品周报”、“写月报”、“做个竞品对比”、“帮我排一下这季度需求”、“给老板写个版本计划”、“看看这个 roadmap 缺什么”等表达,或提及产品经理、路线图、版本计划、优先级排序、产品汇报时。
---
# 产品经理(PDM)文档技能
当用户要求撰写或评审产品经理常用文档时,先确认**文档类型**(路线图 / 需求优先级 / 版本规划 / 竞品分析 / 产品汇报),再按该类型的模板与规范生成一篇完整文档,或输出符合性检查结果。
## 工作模式
- **生成模式**:输入为文档类型 + 零散素材,输出为按模板整理好的完整 Markdown 草稿。
- **补全模式**:输入为半成品草稿,输出为补全后的版本,并保留仍待确认的占位项。
- **评审模式**:输入为已有文档,输出为符合项、缺项、必改项、建议项。
- **重写模式**:输入为口语描述、会议纪要或旧文档,输出为按团队模板重组后的版本。
## 执行前
- **文档类型**:根据用户表述判断——“路线图”、“roadmap”、“今年做什么”、“Q2 做哪些方向”→ 路线图;“优先级”、“排需求”、“backlog”、“这批需求怎么排”、“先做哪个”→ 需求优先级;“版本规划”…