ethanreedlabs/sulde/record-prd-supplement

# 协调端先 grep PRD 找最相关章节
grep -n "^## \|^### " "<项目文档区>/PRD/<产品需求文档>.md" \
  | grep -i "{需求关键词}" | head -5

### {补充节标题}(YYYY-MM-DD 甲方补充)
 
{简短描述 — 2-4 句话讲清楚甲方说了什么}
 
{实现要求或交互约定 — 列点式}
 
详细规则见 UI 行为契约 §X.Y。

### X.Y {规则标题}(PRD §X.Y 补充,YYYY-MM-DD 甲方追加)
 
{背景 1-2 句:同一设计稿/同一行为被复用 / 触发条件等}
 
| 场景 / 维度 | 触发 / 形态 | 视觉来源 / 实现位置 |
|---|---|---|
| ... | ... | ... |
 
**两端硬约束**:
 
| 端 | 一份实现 | 形态 A | 形态 B |
|---|---|---|---|
| iOS | `XxxView` | 整页 / fullScreenCover | .sheet 包裹 |
| Android | `XxxFragment` | 整 frame | BottomSheetDialogFragment |
 
**禁忌**(关联 §7.1 复用优先):
-❌ 双 UI 重复实现
-❌ 弹窗形态自改设计
 
**Cross-Ref**:`pen-truth/{pageId}.md §X` 同步标注本规则。

---
 
## N. 复用/补充 Cross-Ref(YYYY-MM-DD 甲方补充)
 
{说明:本设计稿对应 X 种触发场景 / 行为补充}
 
| 场景 | 触发 | 形态 |
|---|---|---|
| ... | ... | ... |
 
详见 PRD §X.Y "{标题}" + UI 行为契约 §X.Y。
 
**两端实现 1 个组件**,宿主决定形态。**禁止做两套 UI**(违反 UI 行为契约 §7.1)。

"<page-a>":
  ...
  reuse-context:        # 共享视觉的多触发场景
    - integral-page
    - <shared-modal>
  supplement-note:      # 简短甲方补充注解(可选)
    - "同视觉两形态:入口整页 / 功能拦截弹窗"
  ...
  source: ... + YYYY-MM-DD-甲方补充

python3 <<'EOF'
import re
path = "<docs-hub>/design/page-relation.yaml"
with open(path, "r", encoding="utf-8") as f: content = f.read()
old = '... 原文(全角括号)... '
new = '... 改后 ...'
if old not in content: print("未匹配,grep 实际位置:", content.find("锚点字符串"))
else:
    with open(path, "w", encoding="utf-8") as f: f.write(content.replace(old, new, 1))
    print("OK")
EOF

- date: YYYY-MM-DD
  action: prd-supplement-record
  page: {pageId}
  by: coordinator
  source: 甲方口头补充 + 协调端 /record-prd-supplement skill
  note: |
    {一句话总结甲方补充内容}
    落到 4 处:PRD §X.Y / UI 行为契约 §X.Y / pen-truth/{pageId}.md §N / 本 yaml entry

甲方补充已落 4 处文档 ✅
 
| # | 文件 | 改动 |
|---|---|---|
| 1 | PRD V3 §X.Y | {简述} |
| 2 | UI 行为契约 §X.Y | {简述} |
| 3 | pen-truth/{pageId}.md §N | {简述} |
| 4 | page-relation.yaml `<page-a>` 条目 | reuse-context + audit-log |
 
信息流闭环:甲方补充 → PRD → 契约 → 设计稿层 → 图谱
任何 Dev /ui-impl 看任一处都会被引导到同一组件实现。