不写代码的 PM 也能交付产品:45 个技能,来自三个已上线产品
45 个 agent 技能,来自三个已上线产品的实战:决定做什么、用 Claude Code 或 Codex 构建、让第二个模型审查、发布。
任何时候迷路了?输入 /product:start-here(Codex 里是 $product:start-here),说明你手上有什么。它会告诉你当前工作进展到哪一步、下一步是什么。先安装。
这些技能可以在 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、GitHub Copilot 以及任何能读取 SKILL.md 文件夹的 agent 中运行。免费,MIT 许可证,来自 The Product Compass。
谁适合用
- 用编码 agent 交付产品的产品经理、创始人和设计师。不需要写代码:你做决策、检查产品,而不是逐行检查代码。
- 构建产品而不只是写代码的工程师。这意味着要决定做什么,并让它在生产环境中跑起来,面对真实用户和真实支付。
- 任何同时使用多个 agent 的人——一个会话负责协调,另一个负责构建,第三个负责审查。
用它构建的产品
作者用编码 agent 从第一个原型到生产构建了三个已上线产品。技能中带日期的案例都来自它们。
AskOne:实时问答与投票。支持双角色的组织、付费计划、免费 AI 审核、Zoom 和 Google Meet 应用,以及一个在官方注册表中的 MCP server(Model Context Protocol,模型上下文协议)。
Staygreen:检查应用实际返回内容的监控。三大洲的探测点、自有域名上的状态页、告警,以及供 agent 使用的 MCP server。这里是默认监控。
AFK Pilot:四个编码 agent,运行在编辑器、桌面应用或云主机中,通过中继从手机操控。有付费计划、MCP 连接器。
每个产品用什么技术栈、包含什么、技能从中学到了什么,见 CASE-STUDIES.md。
安装
最快的方式:在项目文件夹中打开你的 agent,在对话里说:
Please install skills from phuryn/product-engineering on GitHub in this project only. Enable auto updates.
在 Claude Code 或 Claude 桌面应用中,这会把六个 pack 只为本项目启用(.claude/settings.json),后台自动更新。提交这个文件后,所有在 Claude Code 中打开该仓库并信任该文件夹的人也会获得它们;只想自己用,就要求 local 作用域(.claude/settings.local.json)。这些 pack 会在同一会话中加载(在终端里,如果找不到 /product:start-here,运行 /reload-plugins)。然后输入 /product:start-here 并说明你手上有什么。
在 Codex 中,插件是安装到你的用户下、对所有项目生效:运行下面的 Codex 命令,开一个新会话,然后输入 $product:start-here。如果你的 agent 无法通过提示词安装,就用下面的命令。
用多个 agent?Claude Code 和 Codex 从不同位置读取技能,所以你在哪个里工作就在哪个里安装。当一个 agent 负责协调并驱动其他 agent 时,它需要这些技能;而构建者需要安装 app-stack,用于界面和 MCP server(它的任务说明里会点名);审查者则故意不装这些。
安装 pack 后,运行一次 agent-instructions 技能来装配产品的入口文件:从技能默认值出发的 owner 选择、文档索引,以及已安装 pack 的路由行——产品的界面或其 mock → 应用 ui-design;触发部署的 push 或发布 → 应用 release-gate;审查循环 → 应用 independent-review;委派 → 应用 delegation;给集合的一条经验 → 输入 /agent-harness:retro(Codex: $agent-harness:retro)。在已有代码的产品中,同一遍还会读取每个已安装技能中与代码相关的部分,对照代码,并补上那些技能点名但缺失的测试。
Claude Code 安装命令
claude plugin marketplace add phuryn/product-engineering
claude plugin install product@product-engineering
claude plugin install ai-shipping@product-engineering
claude plugin install agent-teams@product-engineering
claude plugin install agent-harness@product-engineering
claude plugin install app-stack@product-engineering
claude plugin install work-humanizer@product-engineering
这些命令会把插件安装到你的用户下、对所有项目生效。给每一行加上 --scope project 就只对当前项目生效(.claude/settings.json,提交后共享),或者加 --scope local 只对你自己在当前目录生效。
然后开启更新,第三方 marketplace 默认不开启:/plugin → Marketplaces → product-engineering → 启用 auto-update。手动更新:在同一界面点 Update marketplace,或者运行 claude plugin update <pack>@product-engineering。
如果同一个仓库的多个 worktree 都用了 project 作用域安装,更新后请检查 ~/.claude/plugins/installed_plugins.json 里每个 worktree 的条目(projectPath 和 gitCommitSha):该命令可能作用在另一个 worktree 的记录上。(2026-11-07,一个实时问答产品,Claude Code 2.1.319:有三个 worktree 时,一次更新改动了另一个 worktree 的记录,然后报告“已是最新版本”,而发起更新的 worktree 仍停留在旧 commit;同一天更新到 v1.6.0 时,它在另一个 worktree 的路径下报告六个 pack 都已更新。)
Codex 安装命令
codex plugin marketplace add phuryn/product-engineering
codex plugin add product@product-engineering # 以及其他 pack
Codex 直接读取本仓库的 Claude Code marketplace,所有技能都能在那里运行。需要你手动触发的四个技能只有在你点名时才运行:$product:start-here、$ai-shipping:ship-check、$agent-harness:handover、$agent-harness:retro。其余技能在你用自然语言提出需求时也会自动启动。更新:codex plugin marketplace upgrade product-engineering,然后开新会话。
当 Claude Code 把构建任务交给 Codex 时,Codex 只读取装在 Codex 里的 pack,所以要在 Codex 中安装构建所需的东西:用于界面和 MCP server 的 app-stack。
其他 agent(Cursor、Gemini CLI、OpenCode、Copilot、Windsurf 等)
npx skills add phuryn/product-engineering # 交互式选择技能和 agent
npx skills update # 之后用于更新
npx skills 需要 Node.js 22.20 或更高版本;版本更旧会报错 does not provide an export named 'glob'。升级 Node,或者通过临时的 Node 22 运行:npx -p node@22 -p skills -c "skills add phuryn/product-engineering"。
或者手动把技能文件夹复制到你的 agent 读取的目录(.agents/skills/、.claude/skills/、.cursor/skills/、~/.gemini/skills/ 等)。每个技能只靠自己的文件夹就能工作。同一个技能既复制又作为 pack 安装会加载两次:保留一个,优先保留会更新的 pack。
与 pm-skills 共存
也在用 pm-skills?两者可以配合:pm-skills 覆盖发现、战略、研究、执行和 go-to-market;本集合覆盖用编码 agent 构建、发布和运行产品。
它的 AI Shipping Kit 已经搬到这里,成为 ai-shipping pack。它在 pm-skills 中的技能和命令现在只指向这里,所以装好 ai-shipping 后,关闭 pm-ai-shipping。它的 id 在 claude plugin list 里:pm-ai-shipping@pm-skills,如果来自你的 claude.ai 账户则是 pm-ai-shipping@synced(claude plugin disable <id>)。
有五个产品技能两边都有(competitor-analysis、market-segments、value-proposition、beachhead-segment、growth-loops),以这里的为最新。pm-skills 把它们和其他许多技能放在一起,所以保留那些插件;这五个技能各会加载两次,你的 agent 会用其中任意一个副本。
免费的 work-humanizer 如果你单独装过,和这里的 pack 是同一个技能:保留一个。
从第一个想法到付费用户
一分钟内能检查完的改动可以直接跳到第 4 步。每一步都带示例,从第一个提示词到下一轮:见 WALKTHROUGH.md。
第 1 步:Start
你做什么:说明你手上有什么——一个想法、用户证据、商定的改动、一个 bug 或一次发布。
Agent 做什么:读取请求和仓库,指出下一步。
技能:start-here。
第 2 步:Proposal
你做什么:先看关键界面。然后读研究、做未决决策,接受或说明要改什么。
Agent 做什么:研究你没分享的部分——人们使用的替代方案,以及在未定时研究细分市场。用一个 artifact 提出方向,每个论断都带来源:jobs map、每个关键 job 在样本数据上的高保真界面,以及每个带建议的未决决策。
技能:propose,配合 competitor-analysis、market-segments、beachhead-segment、value-proposition、value-curve、growth-loops;界面用 ui-design。
第 3 步:Plan(仅复杂改动)
你做什么:审阅它的关键假设(它如何理解你的需求、哪里不同意你、需要你决定什么),界面变化时还要审阅 artifact 中的新界面和选择。质疑看起来不对的,然后说“build it”。
Agent 做什么:先列出关键假设,然后规划构建所需的一切:阶段与发布、以构建者小时计的粗略规模、要改的文件和模块、如何测试、验收标准。会变化的界面和未定的选择写进 artifact。
技能:start-here 负责提示词;SaaS(Software as a Service)用 app-lifecycle。
第 4 步:Build
你做什么:当某个阶段提供选项时做选择,比如设计方向。应用需要账户、密钥或域名时,按 agent 的引导设置:密钥放在 agent 要求的位置,绝不发进对话,生产密钥只在它要求时提供。你不用逐行审代码。
Agent 做什么:一个会话协调,另一个构建;没有会话审查自己的工作。测试和文档随改动落地,每个修复都配一个在修复前失败的测试。一个从未看过构建的全新审查者审查每个完成的阶段和每次触发部署的 push,并在修复一轮发现的问题后再审,直到达标。使用你指令中指定的审查者。默认 wrapper 会按 Codex、Claude Code、Grok 的安装顺序启动一个全新会话。在第一个陌生人被要求做任何事之前,法律页面会从代码起草出来供你批准。
技能:delegation、codex-agents、claude-agents、grok-agents、test-harness、code-review、independent-review、ui-design、legal-pages。
第 5 步:Click-through
你做什么:阶段检查后,通过链接点一遍关键用户流程。中型应用留 15 到 20 分钟。可以要求提前预览,agent 会在产品能完成核心 job 时建议停下来试用。
Agent 做什么:阶段关闭和任何收尾部署后,发一个链接、操作和预期结果。日常界面改动用渲染检查。新增或实质变化的流程和 kit 改动跑完整视觉检查。记录未构建的工作,把反馈变成进行中阶段的阶段。你试用预览时下一阶段可以开始。
技能:start-here、release-gate § Stage and phase close、ui-design。
第 6 步:Release review
你做什么:选择跑哪些更深的检查,并决定文档、覆盖图和代码不一致时以谁为准,因为为了让文档匹配错误代码而重写文档,等于给 bug 发通行证。
Agent 做什么:发布前提出更深的检查:文档和法律页面对照代码、覆盖图、安全和性能。跑你选的那些。
技能:document-app 和 check 模式下的 derive-tests;intended-vs-implemented、security-audit-static、performance-audit-static。
第 7 步:Release
你做什么:检查阶段承诺的内容。探索变化的界面和共享面,上线时和广泛 UI 改动时做一次完整扫描,然后说 go。沉默不等于 go。
Agent 做什么:再次审查所有未发布的内容,直到某一轮没有发现本次引入的 Low 以上问题,也没有任何年龄的 High 或 Critical。为每个前置条件收集证据,晋升并验证被审查的构建正在提供服务。
技能:release-gate。
第 8 步:Real users
你做什么:带来人们做了什么——分析、支付、支持记录。
Agent 做什么:运行生产:数据、登录、支付、邮件、监控,以及不使用 cookie 就能回读人们行为的分析。用新证据权衡每个假设,提出下一轮。
技能:product-analytics、environments、supabase-production、clerk-production、saas-authorization、transactional-email、uptime-monitoring;propose。
技能清单
大多数技能在工作与其用途匹配时会自动启动。需要你启动的有四个,下面已标注:Claude Code 里用 /<pack>:<skill>(例如 /product:start-here),Codex 里用 $<pack>:<skill>,从复制到仓库的文件夹加载时用 /<skill>(Codex: $<skill>)。
product:决定做什么
- start-here(你启动):工作进展到哪,下一步是什么
- propose:研究、关键界面和决策放在一个 artifact 里
- competitor-analysis:最多五个直接竞争对手、替代品,以及在哪里做出差异
- market-segments:三到五个细分市场、它们的 jobs 和痛点
- beachhead-segment:第一个要拿下的细分市场
- value-curve:你与替代方案逐需求对比
- value-proposition:6 部分价值主张
- growth-loops:能复利增长的增长循环
ai-shipping:发布一个你愿意签字的 AI 构建应用
- ship-check(你启动):给没有文档的应用生成你可签字的 packet
- code-review:正确性,加上安全和性能
- independent-review:全新审查者,一轮又一轮
- intended-vs-implemented:代码与其应有行为不一致之处
- shipping-artifacts:让应用可被审阅的文档
- release-gate:预览、go/no-go、晋升、验证
- test-harness:绿灯真正有意义的测试
- document-app:从代码写系统文档
- derive-tests:把文档变成测试覆盖图
- security-audit-static:有证据支撑的安全风险
- performance-audit-static:N+1 查询、过度获取、缺失索引
agent-teams:其他 agent 作为伙伴
- delegation:任务说明,以及什么永远不委派
- codex-agents:Codex 作为对等方、构建者或审查者
- grok-agents:Grok 作为对等方、构建者或审查者
- claude-agents:Claude Code 作为对等方、构建者或审查者
- gemini-agents:通过 Google 的 Antigravity CLI 使用 Gemini,只在你要求并先同意时。Google 不支持消费者计划(FAQ 读取于 2026-11-13),并说可能导致封禁
agent-harness:可靠的 agent 配置,你在回路中
- handover(你启动):下一次会话开始时的交接说明
- retro(你启动):一次会话的经验,融入你的配置
- agent-instructions:每次会话都读的 AGENTS.md 或 CLAUDE.md
- guardrail-hooks:规则变成 hook
- flight-deck:能挺过压缩的状态看板
- windows-agent-shell:让 agent 出问题的 Windows 陷阱
app-stack:Next.js、Supabase、Clerk 和 Netlify 上的 SaaS
它的 ui-design 也为 propose 绘制关键界面,所以要挨着 product 安装。
- app-lifecycle:从想法到生产,逐阶段
- saas-authorization:每个 workspace 里谁可以做什么
- supabase-production:生产数据库
- clerk-production:登录、组织和计费
- environments:开发和生产分开
- ui-design:每个界面从用户 job 出发,然后设计、构建、评判
- transactional-email:带收据和一键退订的邮件
- legal-pages:与代码匹配的条款、隐私政策和同意
- product-analytics:你的 agent 能回读的无 cookie 录屏和热图
- uptime-monitoring:在用户发现之前知道它挂了;默认使用作者做的 Staygreen
- mcp-server:一次做对的远程 MCP server
- chatgpt-plugin:通过 OpenAI 的插件审核
- embedded-agents-messages-api:应用内的 Claude agent,基于 Messages API
- embedded-agents-agent-sdk:同上,基于 Agent SDK
work-humanizer:不像 AI 写的职场写作
- work-humanizer:编辑像 AI 写的文本,或者采访你
45 个技能中 28 个学自用 Claude Code、Codex 和 Grok 构建的真实产品;14 个是成熟方法(product 里的战略框架、ai-shipping 里的文档和审查方法);product-analytics 基于其供应商文档,work-humanizer 基于一次检测器测试;gemini-agents 基于一天的 CLI(command-line interface,命令行界面)运行和 Google 文档。每个 pack 的 README.md 对每个技能有更多说明。
技能对 agent 的成本
你的 agent 始终携带 41 个自动启动技能的描述:约 6,200 个字符,在 Claude Code 中约 2,700 个 token。技能全文只在运行时加载。tools/validate.py 把描述总量限制在 6,200 字符、每条 300 字符,因为 agent 配置拥挤时描述会被截断,而被截掉的恰恰是说明何时使用该技能的那部分。
工作原理
先有证据再构建
Agent 读取你分享的内容,并研究缺失的部分:替代方案、市场、人们的说法。它提出有依据的假设,每个都带来源,只问证据无法决定的事。
你在看得见的东西上做决定
一个 artifact 承载研究、高保真关键界面和未决决策;构建读取你接受的内容。Agent 工作时,等待你处理的事项都在一页上,每项都带建议。构建并审查完后,你点一遍;发布前,agent 提出对文档、测试和代码的更深检查,你挑选要跑哪些。
构建就是实验
现在构建很便宜,使用胜过意图。几天内构建出带支付的第一版,放到真实用户面前,然后根据他们的行为再来一轮。人们看得见的东西优先,因为便宜:落地页、定价和法律页面随第一批界面一起出,难啃的逻辑等产品值得时再做。
生产是方法的一部分
支付在生产环境跑通之前,没人会付钱。发布门、环境、授权、计费、邮件和监控都在集合里,不留到以后。
写代码的会话永远不清除自己的代码
每次触发部署的 push 之前,以及发布之前,一个从未看过构建的全新审查者会一轮又一轮地读改动,直到某一轮没有发现本次引入的 Low 以上问题,也没有任何年龄的 High 或 Critical。默认 wrapper 会选择已安装的 Codex、Claude Code、Grok 中的第一个,开一个全新会话。你的 agent 指令里可以指定另一个或另一种顺序,前提是它能按 independent-review 要求的方式运行:只读、不开 MCP server、关闭记忆。
小改动不搞仪式
一分钟能检查完的改动直接进构建和检查。只有复杂改动才需要计划,而且由 agent 来写。
这套流程就是 Product Engineering for PMs 系列里的流程,那个系列用它一步步构建一个真实的 SaaS 应用。
与面向工程师的技能集合有何不同
面向自己拥有代码的工程师的集合,把它们该做的事做得很好:测试先行的代码,用你逐行审阅的语言。这个集合从不同的地方出发,检查不同的东西。
| 面向工程师的集合 | Product Engineering | |
|---|---|---|
| 出发点 | 你的想法,经访谈打磨 | 证据:研究替代方案和细分市场,然后是一份每个论断都带来源的提案 |
| 提问 | 关于你的想法;没有市场研究 | 研究之后问几个,每个都带建议答案 |
| 规格 | 一份文档,然后是任务或工单 | 一个 artifact:研究、关键界面和决策;没有工单 |
| 你检查 | 代码,逐行 | 你在提案、计划、一页等待事项里的决策;发布的证据;以及产品本身——点遍每个你能看见的改动 |
| 测试 | 先写 | 随改动落地;每个修复配一个先失败的测试 |
| 审查者 | 写代码的会话,或它的子 agent | 从未看过构建的全新审查者,默认 Codex,或指定的替代者如 Grok |
| 终点 | pull request,有时是部署 | 付费用户:法律页面、登录、支付、邮件、分析和生产监控,通过一次你说 go 的发布;然后是下一轮 |
三种常见失败及防范
任何技能集合都可能出三种问题,这个集合对它们做了防范:
决策在文档之间丢失,决策记录越堆越多然后过期。这里只有一份提案,构建读取它,建议是重写而非追加;对 SaaS,有真实选项的选择进一个决策日志(app-lifecycle),每条都带重新打开它的触发条件。
技能加载不到它依赖的东西。每个技能只靠自己的文件夹工作,并且有校验器检查每个技能和技能点名的每个文件。
规则读起来像常识,背后却什么都没有。实践中习得的规则保留凭据——日期和坏了什么或被测量了什么,大约 700 条;新规则需要一次被观察到的失败。
脚本
有些技能附带脚本——Codex wrapper、review wrapper、Claude wrapper、hook 模板。它们需要 Python 3.9+(标准库,技能另有说明的除外)和它们驱动的 CLI。每个技能会说明需要哪个。除非你的 agent 运行它,否则什么都不会跑。
更多技巧
更多发现、优先级排序、实验和 go-to-market 技巧,见免费的 PM Skills 集合。
更新与反馈
技能会随 agent 和平台变化;里面每条平台事实都带日期。改了什么在每个 commit 里。集合决定不采纳的请求及原因在 rejected.md。问题和报告:开一个 issue。
许可证
MIT:见 LICENSE.md。