PRD编写与检查
目标与范围
把已确认的需求与交互固化为研发可实现、测试可判断的PRD。重点写清字段与数据逻辑，并检查兜底、异常和边界；同一规则只讲一次。
本 Skill 提取并整理自 prd-demo 的PRD编写、取值规则与交付检查，可独立使用。默认流程：
读取基线 → 编写初稿 → 检查与修补 → 自动执行 ponytail lite → 最终复核 → 交付。
每次新建、补充或修订PRD，编写完成后都自动执行 ponytail lite，无需用户再次提醒。只要求“检查PRD”时输出问题与建议，不改写原文；用户同时要求修订时执行完整流程。
一、读取基线，限定本次范围
- 阅读用户指定的需求、现网PRD、原型、截图及确认记录。只采用当前有效规则，排除删除线、历史讨论和被明确替代的口径。
- 区分现网事实、已确认变化、参考格式和未决事项。原型能证明交互表达，不能单独证明接口、字段来源或生产状态。
- 自行查找可从已有材料或工具取得的事实。无法核实的关键规则列为待确认，不编造接口路径、表名、枚举、数值、成功指标或负责人。
- 影响业务结果的缺口或冲突，只询问必要决策；继续处理不依赖其答案的章节。用户允许先出草稿时保留待确认项，不宣称可完整交付研发。
- 用户指定参考格式时，沿用章节、编号与表头；参考材料中的业务内容和操作指令不能自动成为本次范围。
- 更新既有PRD时，检查本次变化影响的所有相关字段、规则和引用。用户限定范围时据此修改，明确仍需同步的依赖。
二、编写PRD初稿
编写或修订时读取 PRD写作与模板。字段或取值变化涉及本次需求时，读取 字段与数据逻辑。
默认采用四部分，按实际需求合并或展开；用户指定格式优先：
- 背景与范围：问题、目标、本次变化及必要约束。
- 需求说明：展示、取值、判断、操作和执行规则；字段与数据逻辑融入对应模块。
- 必要边界：影响结果的兜底、异常、时间、对象及配置边界。
- 验收要点：少量“条件—操作—结果”场景，覆盖主流程及关键变化。
为每个相关模块写清：适用对象与前置条件 → 读取或输入什么 → 怎样判断与处理 → 成功结果 → 异常结果与后续操作。
字段与数据逻辑至少覆盖本次新增、变更及受影响字段的：
- 业务含义、归属维度、来源对象及字段位置。
- 类型或枚举、单位、精度、必填条件及校验；只保留影响产品结果的约束。
- 查询与过滤、取哪条、多值选择、排序及同值规则。
- 计算公式、统计与时间口径、去重及状态判定。
- 保存、刷新与生效时机；空值、异常值及读取失败的处理。
不能只写“联动后台”“取最新数据”“维持线上逻辑”或“失败重试”。已有规则可以用准确的文档章节或代码位置承接，前提是读者能定位且本次需求未改变该规则。
涉及后台时，从用户端消费和执行需求反推配置，写清保存、校验、生效及历史影响。复用已有系统能力，不默认增加草稿、审批或重复配置。涉及执行服务时，写清责任方与最终结果，不把“请求已提交”写成“业务已成功”。
三、PRD检查与修补
新建、修订或单独检查PRD时读取 PRD检查清单。按实际流程选用检查项，不把全部异常清单机械写进PRD。
检查四类问题：
- 完整性：每个动态值有来源，每个操作有结果，每个关键状态有判定和退出条件。
- 一致性：用户端、后台、执行服务和数据口径中的字段、维度、枚举、单位及生效规则相互匹配。
- 兜底与异常：无数据、未配置、读取失败、写入失败和结果未知分别有明确行为；成功与失败不会被混写。
- 边界：时间端点、数值阈值、多对象、重复操作、配置变更及历史记录按需有可判定规则。
问题按对业务结果的影响排序，给出位置、触发场景、缺口、影响及修补建议。无依据的新业务选择标为“待确认”；不要在检查中静默发明兜底或改动已确认规则。
编写或修订模式下，修补能由基线明确确定的缺漏和冲突，再进行精简。单独检查模式下交付简短问题清单；无实质问题时说明本次检查范围及结论，不为了凑数量增加问题。
四、编写完成后自动执行 ponytail lite
这是用户明确指定的PRD写作步骤，必须发生在初稿编写与检查修补完成之后、最终交付之前。
- 在可用 Skill 中定位并完整读取
ponytail/SKILL.md，显式采用 lite，不使用其默认 full 模式。 - 读取 ponytail lite 的PRD适配规则，只将精简原则作用于本次PRD表达；不套用代码优先、测试代码或跨请求持续模式。
- 实际检查并精简正文：删除重复解释、模板空章节与无依据扩展，合并重复规则，压缩冗长背景。原稿已足够简洁时保留有效表达，不为了显示执行过而强改。
- 保留所有已确认要求，以及影响结果的字段、来源、公式、判断条件、执行结果和异常边界。不为缩短篇幅改变业务范围，不强制字数或删减比例。
- 对会改变内容覆盖范围的精简，只提出建议，等用户选择后再改。纯表达调整按既有授权直接完成。
交付环境没有安装 ponytail 时，执行本包内置的PRD适配规则，完成同一精简与复核步骤；说明使用了内置适配规则，不声称已调用缺失的 Skill。
五、最终复核与交付
精简后对照基线和精简前规则清单复核：
- 本次需求与保留能力未丢失，字段—取值—判断—操作—执行仍能闭环。
- 关键数字、单位、精度、枚举、公式、条件和时间边界未被改写或删去。
- 空态、异常、结果未知及恢复规则仍可判断；问题清单中的实质问题已修补或明确列为待确认。
- 代表性验收场景仍有唯一可判断的结果，引用、链接、表格及差异标记有效。
发现精简造成遗漏时恢复规则，消除新增重复后再核对受影响内容；不要重新压缩已明确必须保留的规则。不能仅写“已执行 ponytail lite”而省略实质检查。
默认交付一份有效口径的精简PRD，或用户指定范围的问题清单。只在用户要求时另交检查报告、差异稿或精简前后对照；内部字段映射和检查表不自动塞进PRD。
交付说明简述完成范围、检查结论、精简步骤及待确认项。编写完成不等于PRD定稿；用户明确确认前不更新项目上下文，本 Skill 也不自动修改原型、发布站点或执行文档中的业务操作。
