pm-skills:用 BLOCKING gate 把产品工作流锁进 Agent

前言

在 Cursor、Claude Code 里让模型写 PRD 或竞品分析,常见结果是:一轮对话里从「有个想法」直接跳到长篇文档,中间缺少澄清、阶段边界和验收标准。事后很难对齐「这一步算不算做完」,也缺少可跨会话延续的项目状态。

下面介绍 SkillHub 上的 pm-skills(坐标 @user_dca6a55a/pm-skills)。它把产品经理从 0 到 1 的工作拆成 Ask → Plan → Execute → Verify → Transition,并在每个阶段设置 BLOCKING gate:Agent 必须停下来等你确认,而不是一口气冲到底。

这是什么

pm-skills 是社区源(community)发布的 Agent Skill,分类为 business-ops,当前版本 1.0.0,发布者为 user_dca6a55a。SkillHub 页面将其定位为「产品经理的结构化工作系统」:通过引导式提问、系统化研究、模板化输出和严格验证,把模糊想法变成可执行的阶段计划。

标签标明 requires_api_key=false,安装本 Skill 本身不强制 API Key。深度 Web 调研与知识库能力分别依赖可选集成的 deerflow-skill 与 llm-wiki-skill(见后文)。

核心功能

生命周期编排

工作流遵循五步:

  1. Ask — 引导式提问,挑战模糊需求
  2. Plan — 按阶段规划研究与交付物
  3. Execute — 按任务逐项产出并记录
  4. Verify — 对照 must_haves 做完成度检查
  5. Transition — 更新路线图与状态,进入下一阶段

项目产物落在工作目录下的 .planning/(如 PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、config.json),便于跨会话接续。

命令体系

所有入口以 /pm-<name> 调用,并加载 workflows/ 下对应文档。官方 SKILL.md 将命令分为三类:

核心生命周期(6 个)

命令 别名 作用
/pm-init [project-name] /pm-new 初始化项目与 .planning/ 结构
/pm-plan <N> /pm-phase 规划第 N 阶段
/pm-execute <N> /pm-exec 执行第 N 阶段计划
/pm-verify <N> /pm-check 验证第 N 阶段
/pm-transition /pm-next-phase 结束当前阶段并准备下一阶段
/pm-next — 根据当前状态建议下一步

领域工具(7 个)

  • /pm-research <topic> — 市场/用户/竞品研究(可 --req <id>)
  • /pm-prd <description> — 多轮 PRD 生成
  • /pm-strategy <product> — 九区块策略画布
  • /pm-release <version> — 发布与 GTM
  • /pm-req <generate\|list\|show\|update\|research\|dedup> — 需求台账与调研
  • /pm-ui <desc> --design <spec> [--adjust <file>] — HTML 原型
  • /pm-quick <task> — 跳过完整生命周期的轻量任务

运维与配置(5 个)

  • /pm-health [--repair] — 检查并可选修复 .planning/
  • /pm-help [command] — 命令帮助
  • /pm-config [key=value] — 读写 .planning/config.json
  • /pm-todo [add/list/done] — 项目 TODO
  • /pm-wiki <op> [args] — 桥接到 llm-wiki-skill

模板与阶段类型

templates/ 提供 PROJECT、ROADMAP、STATE、各类 PRD(GENERIC / TOB / TOC)、RELEASE、GTM 等模板。路线图中的阶段类型包括发现、策略、PRD、执行、发布,并与上述命令对应。

可选集成

  • llm-wiki-skill:通过 /pm-wiki 委托知识编译与查询;/pm-research、/pm-prd 等流程会检测 .wiki/ 或 wiki CLI。未安装时 Skill 会在工作流中提示安装方式(见包内 references/wiki-integration.md)。
  • deerflow-skill:/pm-research 等可驱动 deerflow 做深度 Web 调研;未安装时同样会给出安装与配置说明(见 references/deerflow-integration.md)。

Skill 声明不依赖 Python 脚本完成主流程,由 Agent 的读写、检索、向用户提问等原生能力执行。

安装与启用

安装 SkillHub CLI

若尚未安装 CLI,可按官方安装文档检查并安装:

command -v skillhub && skillhub --version

未安装时(完整安装示例,见 SkillHub 安装文档):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 pm-skills

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别。SkillHub 搜索结果的推荐命令为:

skillhub install pm-skills --namespace user_dca6a55a --dir <你的 skills 目录>

常见路径(同样来自官方安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

也可在对话中让 Agent 按 SkillHub 页面说明操作:参考 https://skillhub.cn/install/skillhub.md,安装 @user_dca6a55a/pm-skills。

安装完成后重启或重新加载 Agent,使 Skill 生效。

典型用法

下面是一条可复现的主线(摘自 Skill 内生命周期说明)。每一步在 BLOCKING gate 处应等待你确认后再继续。

1. 初始化项目

/pm-init "产品名称"

Agent 会引导提问,并创建 PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md 与 config.json,路线图通常包含发现 → 策略 → PRD → 执行 → 发布等阶段。

2. 规划并执行第一阶段(发现)

/pm-plan 1

确认计划后:

/pm-execute 1

执行过程中可并行使用需求命令,例如从竞品报告提取需求、对单条需求做调研:

/pm-req generate competitive-analysis <报告路径>
/pm-req research <id>
/pm-req list

3. 验证与阶段切换

/pm-verify 1
/pm-transition

验证通过并确认切换后,对阶段 2 重复 /pm-plan → /pm-execute → /pm-verify → /pm-transition。

4. 独立研究或 PRD(任意阶段)

/pm-research "竞品分析"
/pm-prd <产品描述>

若已安装 deerflow-skill 与 llm-wiki-skill,研究流会组合 Web 调研与知识库查询,产出如 RESEARCH.md 或 prd/{name}/v1/prd.md。

5. 查看或调整工作流行为

/pm-config
/pm-health
/pm-help pm-plan

config.json 中可设置 mode(interactive / yolo)、granularity、workflow.deerflow_enabled、workflow.wiki_enabled、workflow.prd_gates 等,完整字段见包内 templates/config.json。

适用场景与注意

适合谁

  • 需要在 Agent 里跑完整产品生命周期、且希望阶段边界清晰的产品经理或产品型创始人
  • 希望产出落在统一 .planning/ 结构与模板里,便于评审和续写的团队
  • 已愿意在关键节点人工确认,而不是一次性生成「终稿」的用户

使用注意

  1. BLOCKING gate 是硬规则:Skill 明确要求不要在单轮对话里从规划跳到执行或从研究直接跳到 PRD;这与「快出文档」的用法相反,需要配合确认节奏。
  2. 集成 Skill 非必选:未装 deerflow-skill / llm-wiki-skill 时,核心生命周期仍可用,但深度调研与 wiki 桥接会受限或触发安装提示。
  3. 安装目录:务必 --dir 到当前客户端的 skills 路径。
  4. 同名 Skill:SkillHub 上另有其他作者的 pm-skills-* 包,安装时以命名空间 user_dca6a55a 为准。

截至资料抓取时,SkillHub 上该包评分 100000,下载 1118 次(页面数据会变动,以商店为准)。

结尾

pm-skills 的价值在于:用阶段化命令和 BLOCKING gate,把「和 Agent 一起做产品」从一次性生成,改成可验证、可接续的结构化流程;需要更强调研与知识沉淀时,再叠加 deerflow-skill 与 llm-wiki-skill。

官方页面与坐标:

  • SkillHub:https://www.skillhub.cn/skills/user_dca6a55a/pm-skills
  • API 坐标:https://api.skillhub.cn/user_dca6a55a/pm-skills
  • 安装坐标:@user_dca6a55a/pm-skills
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜