PD 原型驱动澄清 → deliver-feature 交接方案

让产品 PD 用自己的 Claude,在真仓库里"所见即所得"地把需求跑通,产出可被本仓库 deliver-feature 高保真消费的分层 spec。设计草稿,供 review。

一句话结论:产品意图(做什么 / 长什么样 / 怎么交互 / 关键业务规则)能高度还原; 技术实现契约(枚举编码 / 乐观锁 / 软删 / 数据模型)不在还原范围,也不该 PD 定,由研发侧 GATE1 补齐。
前提:PD 在真仓库、真设计系统里搭原型,并把原型分支一起交出来——这是成败分水岭。

1还原度分层(拿 ticket-pricing 真实 spec 举证)

内容举例原型能否传递还原度
可见层 页面结构、字段列表、主流程、组件选型、加载/空/错/无权限态、名单类型切换联动 poiid、调价方式切后缀切换 原型所见即所得 + 截图直接传 高 85–95%
产品规则层 优先级可否重复、减价是否兜底、无权限"隐藏 vs 禁用"、生效时间口径、搜索维度(poiid vs 名称) 点不出来,但 PD 能拍板 → 靠漏洞清单逼问 中,取决于是否逼问
实现契约层 枚举 INT 编码(1/2/3)、version 乐观锁、is_deleted 软删、ticket_markup_rule_log、时区落库、ACL 码、JSON scope 结构 原型完全看不见,也不该 PD 定 不在还原范围
关键事实:ticket-pricing/10-prd.md 的 AC1–AC7 + 枚举双向映射 + 乐观锁 + 软删 + 操作日志—— 不可见契约占了 spec 可判定内容的一半以上,PD 点原型一个都点不出来。所以"高度还原"只对可见层与产品规则层成立。

2协作架构(三段)

PD 侧 · 原型驱动澄清

  • 用自己的 Claude + PD skill
  • 真仓库搭原型、mock 数据
  • 对话式调整,所见即所得
  • 漏洞清单逼问产品决策

交接物 · code 平台 issue

  • 10-prd + 20-ui + clarifications
  • 关键步骤截图
  • 原型分支(最大杠杆)

研发侧 · deliver-feature

  • 产物直落 .harness/specs/
  • Phase 0 降级为"补契约"
  • GATE1 对齐 → TDD 交付

本质:把 deliver-feature 的 Phase 0(摄入+澄清+写 spec)中"做什么"那半前移到 PD 侧,且用活原型消除歧义;"怎么实现"仍留研发侧。

3PD skill 流程设计

Phase A · 拉起可视环境(skill 自动化,PD 零门槛)

clone 仓库 → 安装 → 注入 mock + 免登模式pnpm dev

坑②必须先解:本地 BUC 登录跑不通(占位密钥)。skill 要内置"免登 + mock 后端"原型模式,否则 PD 第一步就看不到页面。

Phase B · 生成原型(WYSIWYG)

Claude 在真仓库用 shadcn/ui + Tailwind 语义 token + src/component/layout 搭功能 UI,接 mock 数据。

坑①对抗:强制真组件、禁 antd/硬编码色(对齐 docs/ui)→ 原型天然产线级,截图+JSX 才是可信目标。

Phase C · 对话式调整

PD 看浏览器 →「按钮放右边」「加个空态」「筛选多一个渠道」→ Claude 改 → PD 复看。循环到满意。

Phase D · 结构化产出 + 漏洞清单逼问

Claude 生成 10-prd / 20-ui 草稿 + 截图;并对本功能过一遍漏洞清单(逻辑分支/并发一致性/授权越权/金额精度/时区/歧义/假设依赖),分两栏:

■ PD 可拍板(如优先级可否重复、无权限隐藏还是禁用)→ 当场问,答复入 clarifications.md■ 留研发(枚举编码、锁机制)→ 标注移交,不静默丢。

坑③对抗:漏洞清单是"点不出来的东西"的兜底,杜绝可见原型给人"已想全"的错觉。

Phase E · 交接到 code issue

分层 spec markdown + 截图 → issue;原型分支 push 上去。PD 确认即完成。

4交接契约 → 直落 .harness/specs/(零翻译损耗)

PD 侧产出落到研发侧Owner
10-prd.md(目标/范围/主流程/验收).harness/specs/<f>/10-prd.mdPD
20-ui.md(交互/视觉/状态)同名PD
clarifications.md(PD 拍板答复)同名PD
关键步骤截图.harness/baselines/<f>/(兼作视觉基线)PD
原型分支(真仓库真组件)研发读 JSX 作实现参照PD
30-api / schema.sql / 40-rules / tasks / 测试研发(GATE1 后)
为什么这样最省:产物格式 = deliver-feature 已消费的分层结构,我这边"拉取即进 spec"。 Phase 0 从"从零澄清"降级为"补不可见契约 + GATE1 对齐",起点大幅前移,返工大幅减少。

5四个必对抗的坑(汇总)

① 原型漂移
非真组件 → 截图骗人。
对抗:skill 强制真仓库真组件、禁 antd/硬编码色。
② 本地登录跑不通
PD 看不到页面。
对抗:内置免登 + mock 后端原型模式。
③ 不可见逻辑漏采
点不出并发/精度/越权。
对抗:漏洞清单强制过,两栏分诊。
④ mock ≠ 真后端
空/错态截图非契约。
对抗:截图标注"意图非契约",数据依赖态不当真。

6待你拍板(决定怎么落地)

  1. 原型是否共享分支? —— 强推荐"是"。这是视觉+结构近乎无损的唯一杠杆;只给截图会让缝变大。
  2. PD skill 独立,还是并入 deliver-feature 作前置阶段? —— 建议独立(PD 侧运行环境/权限与研发侧不同),但产物格式严格对齐。
  3. 交接落点:你说的 "code 平台 issue" → mcp__code__create_issue + 截图附件 + 原型分支链接。确认即按此。
  4. 免登/mock 模式怎么做:属实现细节,GATE1 前不动。需要一个 dev-only 的 auth bypass + fixture 层。
草稿仅供 review,未确认前不写 skill 代码。确认方向后,下一步是把 PD skill 的 SKILL.md + 免登 mock 模式 + 交接产物模板落地。