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”、“这批需求怎么排”、“先做哪个”→ 需求优先级;“版本规划”…
— 以上为试看内容(约 40%),开通会员后阅读全文 —