# Pm Prd Requirement Details > 专门写好 PRD 里的「需求详情」：先结论与范围、再冻结事实表（清单/API）、最后用可验收表格写产品方案（编号+规则+验收）。在用户写模型接入、端能力扩展、复杂 Generate 流、或说「需求详情太散/评审看不懂」时使用。触发词：需求详情、可验收、冻结字段、产品方案表格、S-01 类编号、范围与名词、不在本章。 - Skill: `zane-qin/pm-prd-requirement-details` (Agent Skill) - Install (CLI): `npx skillmds@latest add zane-qin/pm-prd-requirement-details` - Raw SKILL.md: https://api.skillmd.com/api/skills/zane-qin/pm-prd-requirement-details/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Product & Planning - Author: Zane-qin (https://skillmd.com/u/zane-qin) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/zane-qin/pm-prd-requirement-details --- # pm-prd-requirement-details ## 与全文 PRD 的关系 - 全文骨架与必备表仍遵守 **`pm-prd-doc`**；文风遵守 **`pm-writing-style-fayemax`**。 - 本 skill 只收紧 **「需求详情」这一章** 的结构与写法，便于研发 / 测试 / 设计对齐。 ## 推荐章节顺序（强制） 1. **本章结论（1 段 callout 或引用块）** 用一句话说清：做什么、覆盖多少对象、§1 / §2 分工。明确「计费 / 埋点 / 接口字段若已在总表或其它章写清，本章不重复」。 2. **§0 范围与名词** 小表：`名词 | 口径`（入口、用户动作名如 Create、会员/外部模型定义等）。 单列 **「不在本章」**，避免需求详情膨胀成百科全书。 3. **§1 模型 / 配置清单（冻结事实）** - 只陈述**可配置事实**：模式、分辨率、时长、声音、成本相关字段等；每行可对照总表。 - 子节按类型拆（自研升级 / 能力扩展 / 新接入）。 - **API 文档对照**单独成节（模型 | 批次 | 链接 | 状态）；缺链写「待补」而非空白。 4. **§2 产品方案（可验收）** - 不要用「需求点 | 需求详情」两列笼统表。改用 **四列**：`编号 | 需求点 | 规则/行为 | 验收要点`。 - 编号建议按域前缀：`S-` 选择器、`P-` 参数、`F-` 流程、`M-` 会员……便于评审口述与用例映射。 - 每条规则必须 **可测**：能看出「怎么验收」，避免「优化体验」「与线上一致」单独出现而无对照物（若确实同线上，写清「错误态与线上一致，对照 xxx」）。 5. **待确认 / 风险** 从正文里拆出未闭环项；区分 **阻塞 / 非阻塞**；删掉重复句、粘贴错误（如同一问题写两遍）。 ## 反模式（不要写） - 飞书里只有一列表格、单元格内丢样式、中英文混用无空格、**同一需求在「清单」和「方案」里各写一套数字却互相矛盾**。 - 「追加 10 个模型」与清单 **11 个** 这种不一致。 - 把 API 说明、埋点、计费推导全塞进需求详情导致没人读完。 ## 成稿后自检（6 条） - [ ] 本章首段能否单独转发给老板 / 研发仍成立 - [ ] §1 任意数字在 §2 中引用时是否一致 - [ ] §2 每一行是否都有「验收要点」 - [ ] 待确认是否无重复、无乱粘贴 - [ ] 「不在本章」是否覆盖埋点 / 后台 / 纯服务端口径 - [ ] 已读 `pm-writing-style-fayemax`：结论前置、表格化、无模糊优先级词 ## 参考范例（可对照） Quokka 第二批外部视频模型 PRD 中「需求详情」重写版（本地路径，便于 diff）： `工作内容/quokka/prd/20260429_quokka-video-models-round2.md` 内 `## 需求详情` 一节。 飞书同步文档（同一内容曾用于对齐）：