PM · PRD → Demo 一体化工作流
把「一个产品想法」走完「对齐 → 产文档 → 出可点原型」的完整链路，产出可交付开发的 PRD、可独立实现的指标定义、以及一个复用基座仓库真实界面的可分享原型。本工作流与宿主无关（Claude Code / Codex / Cursor / Gemini 均可），可移植性说明见「宿主适配」一节。
何时用
- 用户扮演产品经理，要产出 PRD / 指标定义 / 交互稿这类交付物；
- 通常是在已有仓库或系统上做改进，需要复用它的真实结构；
- 希望同时看到一个初步、可点、可分享的原型来辅助评审。
不适用：纯代码实现任务、只改一两行、无产品决策成分的工作。
你会产出什么
- PRD.md —— 唯一事实源（做什么 / 为谁 / 范围 / 风险 / 页面与交互详述）。
- 指标定义.md —— 完全自包含的口径文档，开发只看这一份即可实现每个指标/规则。
- 可分享的自包含 HTML 原型 —— 左=目标界面（复用基座仓库真实 UI + 你的改动，mock 数据必标注），右=完整 PRD 面板。
贯穿三阶段的纪律（不可退让）
- 零编造，一切扎根证据：口径落到源码 / 官方文档 / 用户确认；查不到就明说，不冒充；mock 数据必须显式标注。
- 零 emoji：文档与原型全程不用 emoji / 状态图标；状态一律文字标签（保留 / 升级 / 新增 / 未测 / 待核实 等）。
- 撰写 → 对抗式审查闭环：任何交付文档，先撰写、再由「苛刻的资深 PM」视角审查、按问题修订，循环到通过（审查提示词见
prompts/reviewer-agent.md）。 - 跨产物一致：PRD ↔ 指标定义 ↔ 原型 三者口径必须一致；发现孤儿项 / 自相矛盾就地修。
- 匹配用户的交互风格：有人偏对话、有人偏选项；被拒一次就换方式，不硬塞同一种。
- 决策没锁死不动手：产文档前先把核心决策问清；目标不清就停下讨论，不猜。
- 文字去 AI 味（拟人）：文档正文用自然、直接、像人写的语气，主动规避 AI 腔的典型痕迹（滥用破折号、"不仅是 X，更是 Y"、空洞排比 / 三段式套话、过度对冲、浮夸修饰、正确的废话）。可加载本机
humanizer技能，或参照references/writing-style.md（汇总 stop-slop / Humanizer-zh / blader-humanizer）。注意：技术口径该精确的仍要精确——去味不等于牺牲准确、也不是塞口水话。
阶段 0 · 交互式发现与决策锁定
目标：把用户的真实想法、需求、约束调研并梳理清楚，锁定核心决策——这一步 AI 与人交互完成，不替用户拍板。
- 扒已有资产：读用户给的仓库 / 文档 / 旧系统的真实结构（若宿主支持并行探索就并行扒；否则逐个读）。搞清它实际做什么、有哪些可复用的东西。
- 交互梳理需求：用问答帮用户把模糊想法收敛成明确决策——典型要锁的：基座选谁、范围 in/out、要什么指标/功能、展示/信息架构、明确的非目标。一次问几条关键的，别一次性轰炸。
- 产出决策记录：把锁定的决策写成一份简短的「决策/规划」文件，作为阶段 1 的输入。
出口判据：核心决策逐条有明确答案，用户认可。
阶段 1 · 产 PRD + 指标定义
目标：产出可交付开发的两份文档。
- 对模板：参照
references/prd-checklist.md（国内实操派完整清单 + 按项目类型裁剪），确定这个项目该产哪些节、哪些可跳。 - 撰写：按
prompts/writer-agent.md撰写 PRD 与指标定义。要点：- PRD 覆盖：背景/目标/成功度量/范围/风险/功能结构+信息架构+流程图（可用 Mermaid）/各页面前台展示与交互详述（字段级）/术语表/全局规则/干系人。
- 指标定义完全自包含：把口径全文内联，不写"见其他文档"；开发单看即可实现。
- 审查：用
prompts/reviewer-agent.md的「资深 PM」人设对抗式复核（完整性 / 可执行 / 口径与源码一致 / 范围与非目标 / 风险 / 零 emoji / 无死链 / 跨文档一致）。 - 修订闭环：按审查的必修项改，复核直到通过。
- 过 checklist：交付前对照
references/pitfalls.md逐条自查（这是历次踩坑沉淀的检查项）。
阶段 2 · 出可分享原型
目标：一个左=目标界面、右=完整 PRD 的可点原型；界面设计忠实于既定来源（参考稿 / 基座 / 竞品，见下）。硬性守则见 references/prototype-guardrails.md。
- 确定设计来源（按优先级）：
- ① 用户提供了参考原型 / 设计稿 → 以它为准来做设计，忠实还原它的视觉与布局；
- ② 在某个基座仓库上做改进 → 克隆/读它的前端，提取真实设计令牌与布局（配色 / 明暗 / 侧栏还是顶栏 / 卡片 / 各视图真实字段与表格列），照抄不即兴；
- ③ 都没有 → AI 自行构建，选同类产品 / 竞品的页面作参考来创造，并在原型里说明参考了谁、为什么。
- 建自包含 HTML：单文件，左=目标界面（基座保真 + 你的改动，mock 数据必标注），右=完整 PRD 面板（用极简 markdown 渲染器把 PRD 内联进去）。
- 自包含 / CSP 安全：全部 CSS/JS 内联，不引外部 CDN/字体/图；无法 live 渲染的东西（如某些图库）要诚实标注限制、退化为可读呈现。
- 发布并迭代：发布成可分享链接；用户提改动时，同时改原型和 PRD、保持不脱节，重新发布到同一链接。
交付前检查清单（摘要，详见 references/pitfalls.md）
- 零 emoji（含图表/代码块内的节点标签）
- 无编造：数字/口径都能追溯来源；mock 已标注
- 指标定义自包含，无"见其他文档"式外链
- 跨产物口径一致，无孤儿项 / 自相矛盾
- 原型设计忠实于既定来源（有参考稿照参考稿 / 在基座上则照抄令牌 / 都没有则参考竞品并说明），不是凭空即兴
- 复合分/总分都给了显式公式与构成
- 无法渲染/未测/未知都如实标注，不伪造成事实
宿主适配（可移植性）
本 SKILL.md 正文是宿主无关的自然语言指令，任何 LLM 都能照做。三处差异在正文外解决：
- 加载/触发：各宿主安装与调用方式见
README.md（Claude Code 放技能目录；Codex 走其技能/AGENTS.md 引用；Cursor/Gemini 各自路径）。 - 能力降级：凡提到"派子 agent 审查/探索"，若当前宿主不支持子 agent，就由你自己另起一遍完成同样的审查/探索，不改变纪律。
- 工具无关：正文只描述动作（联网搜、读仓库、写文件、发布原型），不绑定具体工具名；由各宿主映射到自身工具。
附带资源
references/prd-checklist.md—— PRD 组件清单 + 按项目类型裁剪references/prototype-guardrails.md—— 原型硬性守则references/pitfalls.md—— 踩坑检查清单references/writing-style.md—— 去 AI 味 / 拟人写作规则（汇总 stop-slop / Humanizer-zh / blader-humanizer + 本机 humanizer 技能）prompts/writer-agent.md—— 撰写 agent 提示词模板prompts/reviewer-agent.md—— 资深 PM 审查 agent 人设 + 检查项templates/prd-skeleton.md/templates/metric-spec-skeleton.md—— 骨架模板