review

/review

输入：$ARGUMENTS（对比基线分支，默认 main）

---

Phase 1 — 校验

[ -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

if printf '%s' "$ARGUMENTS" | grep -q -- '--dry-run'; then
  node "$DDT_PLUGIN_ROOT/bin/print-dry-run.mjs" --phase review --inputs "git diff <base>..HEAD,docs/prd.md,docs/arch.md" --outputs "docs/review-report.md" --next "/fix（如有 blocker） | /verify"
  exit 0
fi
node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase review --action start
git rev-parse --is-inside-work-tree 2>/dev/null || { echo "❌ 非 git 仓库"; exit 1; }
BASE=${ARGUMENTS:-main}
git diff "$BASE"...HEAD --name-only | grep -q . || { echo "⚠️ 与 $BASE 无 diff，无需 review"; exit 0; }

# 检查上游阶段是否留下未解决 blockers
if [ -f docs/blockers.md ]; then
  unresolved=$(awk '/^- \*\*resolved_at\*\*: null$/' docs/blockers.md | wc -l)
  if [ "$unresolved" -gt 0 ]; then
    echo "❌ docs/blockers.md 中存在 $unresolved 条未解决阻塞，请先处理。"
    echo "   未解决项来自："
    awk '/^## /{h=$0} /^- \*\*resolved_at\*\*: null$/{print "   - "h}' docs/blockers.md
    exit 2
  fi
fi

Phase 2 — 派发 review-agent

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

• git diff $BASE...HEAD（完整差异）
• docs/arch.md（若存在）
• docs/api-contract.yaml（若存在）
• $DDT_PLUGIN_ROOT/templates/review-checklist.template.md（评审清单，插件根——v0.9.3 D19）
• $ARGUMENTS（对比基线）

review-agent 按三级分类产出 docs/review-report.md：

级别	含义	后续行动
阻塞	安全漏洞、数据丢失风险、逻辑致命错误	必须修复后重跑 /review
警告	代码质量问题、缺失测试、性能隐患	建议修复
建议	可读性、命名、注释改进	可选

Phase 3 — 汇总输出

完成后向用户报告：

/review 完成
基线: <BASE> → HEAD

阻塞:  <n> 条
警告:  <n> 条
建议:  <n> 条

报告: docs/review-report.md