design

/design

输入：$ARGUMENTS

---

Phase 1 — 前置校验

test -f docs/prd.md || { echo "❌ docs/prd.md 不存在，请先运行 /prd"; exit 1; }
test -f docs/wbs.md || { echo "❌ docs/wbs.md 不存在，请先运行 /wbs"; 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 --inputs "docs/prd.md,docs/wbs.md,project-brief.md" --outputs "docs/arch.md,docs/api-contract.yaml,docs/data-model.md,.ddt/tech-stack.json" --next "/design-brief (spa) | /impl (server-side|none)"
  exit 0
fi
node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase design --action start
"$DDT_PLUGIN_ROOT/bin/check-blockers.sh" || exit 2

若 docs/api-contract.yaml 已存在且未传 --refresh，进入增量修订模式。

Phase 2 — 解析技术栈（M3-3 优先级链 + M6.3 交互式问卷）

Step 2a：先尝试自动解析

# 提取参数中的 --preset 与 --ai-design（如果有）
PRESET_FLAG=$(printf '%s' "$ARGUMENTS" | grep -oE -- '--preset [a-zA-Z0-9_-]+' | head -1 | awk '{print $2}')
AIDESIGN_FLAG=$(printf '%s' "$ARGUMENTS" | grep -oE -- '--ai-design [a-zA-Z0-9_-]+' | head -1 | awk '{print $2}')

node "$DDT_PLUGIN_ROOT/bin/resolve-tech-stack.mjs" \
  ${PRESET_FLAG:+--preset "$PRESET_FLAG"} \
  ${AIDESIGN_FLAG:+--ai-design "$AIDESIGN_FLAG"} \
  --write

Step 2b：M6.3 交互式问卷（关键）

LLM 必须执行：检查 project-brief.md 中的 "技术栈预设" 字段：

• 若值为 interactive 或 custom：必须用 AskUserQuestion 工具发起 Spring Initializr 等价 4 步问卷
• 若值为具体 preset（如 java-modern）但 project-brief.md 同时含 "后端框架"、"前端框架"等具体字段且与 preset 默认值冲突：用 AskUserQuestion 问 1 题确认偏好
• 若值为 none 或 interactive 且 brief 无具体字段：强制走 4 步问卷，不允许 LLM 自行选栈