prd

/prd

输入：$ARGUMENTS

---

Phase 1 — 前置校验

git rev-parse --is-inside-work-tree 2>/dev/null || { echo "❌ 非 git 仓库"; exit 1; }
# v0.9.3 D19+D20：plugin root 解析提前，让 cp 模板等所有引用都能用 $DDT_PLUGIN_ROOT
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT=$(cat "${HOME}/.claude/delivery-metrics/.ddt-plugin-root" 2>/dev/null)
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT="${HOME}/.claude/plugins/marketplaces/digital-delivery-team"
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || { echo "❌ DDT plugin root 未解析。可能原因：(1) 插件未安装；(2) shell 中 DDT_PLUGIN_ROOT 指向无效路径，请 unset DDT_PLUGIN_ROOT 后重启会话；(3) 运行 /digital-delivery-team:doctor 自检"; exit 1; }
export DDT_PLUGIN_ROOT

若 project-brief.md 不存在：

cp "$DDT_PLUGIN_ROOT/templates/project-brief.template.md" project-brief.md
echo "⚠️ 已创建 project-brief.md 骨架，请填写后重跑 /prd"
exit 1

Phase 2 — 项目 ID 自检

SessionStart hook 已在新会话首次进入项目时自动 bootstrap。命令本身只读取已有 ID：

# v0.9 A2: --dry-run 预览（不读不写、不发事件）
if printf '%s' "$ARGUMENTS" | grep -q -- '--dry-run'; then
  node "$DDT_PLUGIN_ROOT/bin/print-dry-run.mjs" --phase prd --inputs "project-brief.md,docs/prd.md(if exists)" --outputs "docs/prd.md" --next "/wbs"
  exit 0
fi

node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase prd --action start
export DDT_PROJECT_ID=$(cat .ddt/project-id 2>/dev/null || echo "$DDT_PROJECT_ID")
test -n "$DDT_PROJECT_ID" || { node "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" --bootstrap --name "$(basename "$(pwd)")"; export DDT_PROJECT_ID=$(cat .ddt/project-id); }

Phase 3 — 增量 / refresh 选择

若 docs/prd.md 已存在且未传 --refresh，进入增量修订模式（默认）。

若传入 --refresh，重新读取 project-brief.md 与 $ARGUMENTS，刷新受影响章节；仍必须保留已验证内容与变更记录，禁止无差别全量覆盖。

Phase 4 — 派发 product-agent

使用 Task 工具派发 product-agent，传入：

• project-brief.md（项目简报）
• docs/prd.md（已有 PRD，若存在）
• $DDT_PLUGIN_ROOT/templates/prd.template.md（PRD 模板，绝对路径在插件根——v0.9.3 D19）
• brief §11 集成依赖中标注的契约文档路径（v0.9.8 D25）：派发前 grep brief 抽出 §11 提到的 契约文档 \`行（典型形态如项目资料/无人车开放平台API/`），在派发 prompt 里追加："第三方接口契约：< 列出 §11 标注的路径 >；用户故事提到的 endpoint 必须引用契约里的具体路径，禁止编造或写'未确认'作 BLK"；若 brief 无 §11 或 §11 留空，跳过本步。
• $ARGUMENTS（补充说明）