脚本：把重复劳动交给机器

这些脚本用来兜住流程里最容易“手滑”的环节：状态更新、故事校验、环境检查、截图转 Word。

脚本	用途	什么时候用
update_story_status.py	安全更新 user-story.csv 的状态和链接，按状态机校验合法跳转	每次故事状态变化
validate_user_stories.py	校验 CSV 的列、唯一性、状态、依赖和证据路径	提交前 / CI
build_test_report.py	把 E2E manifest + 截图生成可人工走查的 Word 验收报告	⑧ 质量保证 / ⑩ 线上验证
start-chrome-debug.sh	启动可被 Chrome MCP / CDP 控制的 Chrome 实例	本地 E2E 测试
check-env.sh	环境自检：WSL、Node、Python、Chrome、Git、MCP 等	新机器 / 出问题时

典型用法

# 环境自检
./scripts/check-env.sh

# 更新用户故事状态（先预览）
python3 scripts/update_story_status.py \
  --file docs/00-discovery/user-story.csv \
  --story-id US-004 \
  --status integ_done \
  --report docs/03-dev/reports/US-004-创建任务.md \
  --dry-run

# 校验用户故事
python3 scripts/validate_user_stories.py \
  --file docs/00-discovery/user-story.csv --check-paths

# 启动可调试 Chrome
./scripts/start-chrome-debug.sh

# 截图 + manifest → Word 验收报告
python3 scripts/build_test_report.py \
  --manifest docs/04-qa/manifests/US-004.json \
  --qa-root docs/04-qa \
  --out docs/04-qa/e2e-report-dev.docx

状态只能由脚本更新

手改 CSV 极易引发引号、逗号、编码问题，也会让状态和报告不一致。Agent 也不应该被允许直接编辑 CSV。

具体原理和完整示例见 07 AI 编码与多 Agent 并行开发 和 08 质量保证与 Word 验收报告。