design-brief

/design-brief

输入：$ARGUMENTS

把 docs/prd.md + docs/api-contract.yaml + .ddt/tech-stack.json + 用户附件，编译为 docs/design-brief.md（10 字段 SSoT），并准备好供 /design-execute 派生 3 通道（claude-design / figma / v0）的输入材料。

Phase 1 — 前置校验

git rev-parse --is-inside-work-tree 2>/dev/null || { echo "❌ 非 git 仓库"; exit 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 design-brief --inputs "docs/prd.md,docs/api-contract.yaml,.ddt/tech-stack.json" --outputs "docs/design-brief.md,.ddt/design/tokens.json,.ddt/design/components-inventory.md" --next "/design-execute --channel claude-design"
  exit 0
fi
node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase design-brief --action start
"$DDT_PLUGIN_ROOT/bin/check-blockers.sh" || exit 2

# 必需输入校验
test -f docs/prd.md           || { echo "❌ 请先运行 /prd 生成 docs/prd.md"; exit 1; }
test -f docs/api-contract.yaml || { echo "❌ 请先运行 /design 生成 docs/api-contract.yaml"; exit 1; }
test -f .ddt/tech-stack.json   || { echo "❌ 请先运行 /design（会写入 .ddt/tech-stack.json）"; exit 1; }

# frontend.type 三态检查（PR-E）：仅 spa 才需要 brief
FRONT_TYPE=$(node "$DDT_PLUGIN_ROOT/bin/get-frontend-type.mjs" 2>/dev/null)
if [ "$FRONT_TYPE" = "server-side" ] || [ "$FRONT_TYPE" = "none" ]; then
  echo "ℹ️  frontend.type=$FRONT_TYPE，/design-brief 跳过：服务端渲染由 /build-api 处理；纯 API/CLI 无前端工程。"
  node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase design-brief --action end
  exit 0
fi

Phase 2 — 编译 Brief

# 解析 --refresh 与 --visual-direction（透传给编译器）
COMPILE_ARGS=""
printf '%s' "$ARGUMENTS" | grep -q -- '--refresh' && COMPILE_ARGS="$COMPILE_ARGS --refresh"
VD=$(printf '%s' "$ARGUMENTS" | grep -oE -- '--visual-direction [a-z-]+' | awk '{print $2}')
if [ -n "$VD" ]; then COMPILE_ARGS="$COMPILE_ARGS --visual-direction $VD"; fi

node "$DDT_PLUGIN_ROOT/bin/compile-design-brief.mjs" $COMPILE_ARGS || exit 4