【敏捷 FAQ 今日实验室】试用 BMAD——从环境搭建到比较“仅 AI”和“人来回答”（后篇·操作篇）

FROM mcr.microsoft.com/devcontainers/typescript-node:22
# 已包含 Node.js 22（BMAD v6.12 需要 20.12 以上）、git 和 zsh

# 在容器中安装 Claude Code
RUN npm install -g @anthropic-ai/claude-code

USER node

{
  "name": "bmad-lab",
  "build": { "dockerfile": "Dockerfile" },
  "features": {
    "ghcr.io/devcontainers/features/python:1": { "version": "3.12" },
    "ghcr.io/va-h/devcontainers-features/uv:1": {}
  },
  "remoteUser": "node",
  "mounts": [
    "source=${localEnv:HOME}/.claude,target=/home/node/.claude,type=bind",
    "source=${localEnv:HOME}/.claude.json,target=/home/node/.claude.json,type=bind"
  ],
  "customizations": {
    "vscode": {
      "extensions": ["anthropic.claude-code"],
      "settings": { "terminal.integrated.defaultProfile.linux": "zsh" }
    }
  }
}

devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . zsh   # 进入容器中的 shell

mkdir -p trials/support-site && cd trials/support-site
npx bmad-method@6.12 install

npx -y bmad-method@6.12 install --yes --tools claude-code --modules bmm \
  --communication-language Japanese --document-output-language Japanese \
  --directory "$PWD"

[core]
user_name = "Tom"
communication_language = "Japanese"
document_output_language = "Japanese"
project_name = "support-site"

uv run _bmad/scripts/resolve_config.py --project-root .

{
  "core": {
    "user_name": "Tom",
    "communication_language": "Japanese",
    "project_name": "support-site",
    "document_output_language": "Japanese",
    "output_folder": "_bmad-output"
  },

#!/usr/bin/env bash
# 创建 BMAD v6.12 的实验环境（在开发容器中执行）
#   bash setup_bmad.sh [工作文件夹] [称呼]
#   示例：bash setup_bmad.sh trials/support-site Tom
set -euo pipefail
DIR="${1:-trials/support-site}"
NAME="${2:-User}"
BMAD_VERSION="${BMAD_VERSION:-6.12}"

echo "== 检查前提条件"
ok=1
check() {
  if command -v "$1" >/dev/null 2>&1; then
    echo "  ✓ $1 $("$1" --version 2>/dev/null | head -1)"
  else
    echo "  ✗ 未找到 $1"; ok=0
  fi
}
check node; check python3; check uv; check git; check claude
[ "$ok" = 1 ] || { echo "请先安装缺少的内容后再执行一次"; exit 1; }

echo "== 安装 BMAD v${BMAD_VERSION}：$DIR"
mkdir -p "$DIR"
npx -y "bmad-method@${BMAD_VERSION}" install --yes --tools claude-code --modules bmm \
  --communication-language Japanese --document-output-language Japanese \
  --directory "$(cd "$DIR" && pwd)"

echo "== 将对话和文档固定为日语（_bmad/custom/config.toml）"
cd "$DIR"
if ! grep -q '^\[core\]' _bmad/custom/config.toml 2>/dev/null; then
  cat >> _bmad/custom/config.toml <<EOF

[core]
user_name = "${NAME}"
communication_language = "Japanese"
document_output_language = "Japanese"
project_name = "$(basename "$PWD")"
EOF
fi

echo "== 检查设置"
uv run _bmad/scripts/resolve_config.py --project-root . \
  | grep -E '"(user_name|communication_language|document_output_language|project_name)"'
echo "完成。接下来请执行：cd $DIR && claude，然后调用 /bmad-help"

claude -p --dangerously-skip-permissions \
'/bmad-product-brief 请以无头模式执行（headless: true、intent: create）。
输入只有以下这一句话。没有其他信息。
“请为本公司产品的用户创建一个支持网站，最大化提升客户便利性。”
不要向人提问，请遵循技能中 Headless Mode 的指示完成产品简介，并在最后返回 JSON 状态。' \
  < /dev/null > headless_brief.log 2>&1

_bmad-output/planning-artifacts/briefs/brief-support-site-2026-11-09/
├── brief.md      产品简介
├── addendum.md   未能容纳进产品简介的材料（如调研要点）
└── .memlog.md    决策、推测和调研结果的记录

mv _bmad-output/planning-artifacts/briefs/brief-support-site-2026-11-09 \
   _bmad-output/planning-artifacts/briefs/brief-support-site-headless

B=_bmad-output/planning-artifacts/briefs/brief-support-site-headless
claude -p --dangerously-skip-permissions \
"/bmad-prd 请以无头模式执行（headless: true、intent: create）。
输入只有产品简介 $B/brief.md 和 $B/addendum.md。不要向人提问，请遵循技能 references/headless.md 中的指示完成 PRD，并在最后返回 JSON 状态。" \
  < /dev/null > headless_prd.log 2>&1

{
  "status": "partial",
  "intent": "create",
  "open_questions": [
    "★Q1 产品是什么（企业软件／面向消费者／设备）。用户人数和职业",
    "Q2 当前咨询数量、构成、解决所需时间（这将决定目标值和首篇文章的选择方式）",
    "★Q3 现有 FAQ、手册和咨询窗口分别是什么，由谁管理。可以从咨询窗口获取什么内容",
    "…（共 10 项）"
  ],
  "assumptions": [
    "产品为企业软件，用户是不具备该产品专业知识的业务人员",
    "…（共 12 项）"
  ]
}

#!/usr/bin/env bash
# 实验 1：只提供一句需求，让 AI 独自（无头模式）创建产品简介和 PRD
# 在开发容器中执行：bash run_experiment1.sh [工作文件夹]
# 更换题目时：REQUEST="（你的需求）" bash run_experiment1.sh
set -euo pipefail
cd "${1:-trials/support-site}"
REQUEST="${REQUEST:-请为本公司产品的用户创建一个支持网站，最大化提升客户便利性。}"
BRIEFS=_bmad-output/planning-artifacts/briefs
HEADLESS="$BRIEFS/brief-$(basename "$PWD")-headless"
mkdir -p logs

echo "== 1/3 仅由 AI 创建产品简介（需要数分钟）"
claude -p --dangerously-skip-permissions \
"/bmad-product-brief 请以无头模式执行（headless: true、intent: create）。
输入只有以下这一句话。没有其他信息。
“${REQUEST}”
不要向人提问，请遵循技能中 Headless Mode 的指示完成产品简介，并在最后返回 JSON 状态。" \
  < /dev/null > logs/headless_brief.log 2>&1

echo "== 2/3 修改文件夹名称，以免与实验 2 混在一起"
SRC=$(ls -dt "$BRIEFS"/brief-* | grep -v -- '-headless$' | head -1)
mv "$SRC" "$HEADLESS"
echo "   $SRC → $HEADLESS"

echo "== 3/3 基于该产品简介，仅由 AI 创建 PRD（需要十几分钟）"
claude -p --dangerously-skip-permissions \
"/bmad-prd 请以无头模式执行（headless: true、intent: create）。
输入只有产品简介 $HEADLESS/brief.md 和 $HEADLESS/addendum.md。不要向人提问，请遵循技能 references/headless.md 中的指示完成 PRD，并在最后返回 JSON 状态。" \
  < /dev/null > logs/headless_prd.log 2>&1

echo "完成。请确认最后的 JSON（status、open_questions、assumptions）："
echo "  tail -60 $PWD/logs/headless_prd.log"

claude

/bmad-product-brief 我想新建产品简介（现有的 briefs/brief-support-site-headless 是另一项实验，请不要继续该实验）。

请为本公司产品的用户创建一个支持网站，最大化提升客户便利性。

cd trials/support-site/_bmad-output/planning-artifacts   # 从工作文件夹最上层开始
grep -n "\[ASSUMPTION" briefs/brief-support-site-headless/brief.md
grep -c "\[ASSUMPTION" prds/*/prd.md

grep "^- (assumption)" briefs/*/.memlog.md
grep "^- (override)"   briefs/*/.memlog.md

# 来自实验 1（仅 AI）的记录
- (assumption) 假定产品是 B2B 企业软件（套装软件/SaaS）。无依据：仅出现“本公司产品的用户”“客户”等词语。若为 B2C 或实体产品，结构会发生变化
- (assumption) 假定当前咨询窗口以电话和邮件为主，FAQ/手册分散或为 PDF
- (insight) 调研：自助服务中完全解决的比例为 14%，最大的失败原因是“找不到相关信息”43%（Gartner 2024）。网站的核心不是文章数量，而是“能被找到”

# 来自实验 2（人来回答）的记录
- (decision) 当前窗口：已经有一个简单的支持网站。咨询通过邮件、电话和负责销售人员进行
- (decision) 当前网站无用的原因：用户认为文章不足（c）、难以查找（b）（这并非已验证的结果，而是一种判断）
- (decision) 改述（AI 的建议，尚未得到用户确认）：不是“创建网站”，而是创建这样一种状态：“用户能在短时间内、不询问他人的情况下解决操作问题，仍然存在的问题则由非开发人员的窗口受理”
- (override) 撤销“第一版不包含 AI 自动响应”的假设，将利用 AI 纳入第一版范围（用户回答：也希望利用 AI）。使用方式在 PRD 中决定（候选方案：基于文章回答／创建文章草稿／协助一线窗口）