99.2.案例：JAVA开发全流程

# 1. 装 Claude Code
npm install -g @anthropic-ai/claude-code

# 2. 装 Superpowers(主框架)
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# 3. 装 planning-with-files
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

# 4. (可选)装 Taskmaster
npx task-master-ai init

# 5. 验证
claude --version
/help
# 应该看到 /superpowers:brainstorming 等命令

# 让 CC 帮你规范化需求
> /superpowers:brainstorming 我想加一个"满 100 减 20"的促销功能。

请参考需求模板：templates/01-requirement.md，在目录 .history/REQ-YYYY-NNN/ 下创建 01-requirement.md 文件。

> 基于 .history/REQ-YYYY-NNN/01-requirement.md,设计技术方案。
请参考需求模板：templates/02-design.md，在目录 .history/REQ-YYYY-NNN/ 下创建 02-design.md 文件。
> 重点关注:
>   1. 涉及的微服务(订单?商品?营销?账户?)
>   2. 数据库表变更(新增 promo_rule?alter order?加索引?)
>   3. 接口设计(前端?内部 RPC?外部回调?)
>   4. 上下游影响(对账?统计?BI?)
>   5. 性能预估(QPS 多少?需不需要缓存?需不需要限流?)
>   6. 风险评估(分布式事务?幂等?并发?)

# 选项 A:用 Taskmaster(复杂需求)
> 基于 02-design.md 拆任务,设置依赖关系和优先级
请参考需求模板：templates/03-tasks.md，在目录 .history/REQ-YYYY-NNN/ 下创建 03-tasks.md 文件。

# 选项 B:用 Superpowers writing-plans(标准)
> /superpowers:writing-plans 基于 02-design.md 拆任务
请参考需求模板：templates/03-tasks.md，在目录 .history/REQ-YYYY-NNN/ 下创建 03-tasks.md 文件。

# Superpowers 自动
> /superpowers:using-git-worktrees
请参考需求模板：templates/04-worktree-info.md，在目录 .history/REQ-YYYY-NNN/ 下创建 04-worktree-info.md 文件。
# 或手动
git worktree add ../order-service-promo -b feature/REQ-2026-001-promo main
cd ../order-service-promo
claude  # 启动 CC

# 进入 worktree 后
> 按 03-tasks.md 逐项实现
> /superpowers:test-driven-development (强制先写测试)
> /superpowers:subagent-driven-development (子代理并行)
> 用 planning-with-files 写任务进度
> 请参考需求模板：templates/05-changes.md，在目录 .history/REQ-YYYY-NNN/ 下创建 05-changes.md 文件。

# 每个任务完成后自动 commit + 写文档
git add -A
git commit -m "feat(promo): T1.1 create promo_rule table"

# 写决策记录(可选,推荐)
echo "## 决策:为什么用策略模式
- if-else 难扩展,新增促销要改核心代码
- 策略模式符合开闭原则
- 性能损失 < 5%,可接受
- 测试更容易覆盖
" >> .history/REQ-2026-001/decisions.md

# Superpowers TDD
> /superpowers:test-driven-development
请参考需求模板：templates/06-test-report.md，在目录 .history/REQ-YYYY-NNN/ 下创建 06-test-report.md 文件。
# 让 CC 帮你补测试 / 写测试

# 跑测试 + 覆盖率
mvn  test jacoco:report

# 查看报告
open target/site/jacoco/index.html

# Superpowers 自动 review
> /superpowers:requesting-code-review
# CC 会按 4 维度 review:功能正确性 / 代码质量 / 安全 / 性能

请参考需求模板：templates/07-review.md，在目录 .history/REQ-YYYY-NNN/ 下创建 07-review.md 文件。

# 1. 合并代码
cd main-repo
git merge --no-ff feature/REQ-2026-001-promo -m "Merge REQ-2026-001"
git worktree remove ../order-service-promo

# 2. 部署(如配置)
mvn  deploy -Pprod

# 3. 写收尾文档
> /superpowers:finishing-a-development-branch
请参考需求模板：templates/08-summary.md，在目录 .history/REQ-YYYY-NNN/ 下创建 08-summary.md 文件。
# CC 帮你生成 08-summary.md

# 4. 更新 PROJECT_PLAN.md
# 把 [REQ-2026-001] 移到"已完成"

# 假设你的项目根目录是 /home/user/projects/order-service
cd /home/user/projects/order-service

# 1.1 创建 .claude 目录
mkdir -p .claude/commands .claude/hooks

# 1.2 复制本工具箱的 automation 文件
cp /path/to/spring-cloud-workflow/automation/.claude/commands/req-full.md .claude/commands/
cp /path/to/spring-cloud-workflow/automation/.claude/hooks/*.py .claude/hooks/
cp /path/to/spring-cloud-workflow/automation/.claude/spring-templates/*.md .claude/spring-templates/
cp /path/to/spring-cloud-workflow/automation/.claude/settings.json .claude/

# 1.3 给 hook 加执行权限
chmod +x .claude/hooks/*.py

ls -la .claude/
# 应该看到 commands/ hooks/ settings.json 三个东西

# 手动测试(应该无输出说明 OK)
echo '{"user_prompt":"我要做需求", "session_id":"test"}' | \
  python .claude/hooks/stage-tracker.py

# 应该看到:
{"continue": true, "hookSpecificOutput": {"additionalContext": "当前阶段: None/8, 需求: None"}}

# 创建一个空 01-requirement.md,看会报什么
mkdir -p /tmp/test
echo '{}' > /tmp/test/01-requirement.md
echo '{"tool_name":"Write","tool_input":{"file_path":"/tmp/test/01-requirement.md","content":"# 标题\n需求编号: REQ-001\n"}}' | \
  python .claude/hooks/doc-validator.py

# 应该看到
⚠️ [01-requirement] 模板不完整,缺失字段:
   - 需求编号
   - 创建日期
   - 需求方
   - 负责人
   - ## 1. 背景
   - ## 2. 需求描述
   - ## 3. 验收标准
   - ## 4. 不做什么
   - ## 5. 风险与依赖

{"continue": true, "hookSpecificOutput": {"additionalContext": "模板标识：01-需求文档，缺失项：[需求编号、创建日期、需求方、负责人、## 1. 背景、## 2. 需求描述、## 3. 验收标准、## 4. 不做什么、## 5. 风险与依赖]，文档完整性：不完整"}}

# 这个需要先有 JaCoCo 报告
# 跑完 mvn test 后跑:
echo '{"tool_name":"Bash","tool_input":{"command":"mvn test"},"tool_output":"BUILD SUCCESS"}' | \
  python .claude/hooks/coverage-check.py

# 应该看到
📊 覆盖率检查结果: PASS
   总包数: 4, 失败: 0
✅ 覆盖率达标,可以进入下一阶段
{
  "status": "PASS",
  "results": [
    {
      "package": "com.example.my_demo.controller",
      "line_pct": 68.2,
      "branch_pct": 50.0,
      "line_covered": 15,
      "line_total": 22
    },
    {
      "package": "com.example.my_demo.service.impl",
      "line_pct": 100.0,
      "branch_pct": 90.0,
      "line_covered": 32,
      "line_total": 32
    },
    {
      "package": "com.example.my_demo.exception",
      "line_pct": 82.6,
      "branch_pct": 100,
      "line_covered": 19,
      "line_total": 23
    },
    {
      "package": "com.example.my_demo.repository.impl",
      "line_pct": 89.7,
      "branch_pct": 90.0,
      "line_covered": 52,
      "line_total": 58
    }
  ],
  "failed": [],
  "summary": "总包数: 4, 失败: 0"
}

cd /home/user/projects/order-service
claude

claude

# 1. 检查 Python 路径
which python
# 应该是 /usr/bin/python 或类似

# 2. 检查 hook 权限
ls -la .claude/hooks/
# 应该 -rwxr-xr-x

# 3. 检查 settings.json 语法
python -m json.tool .claude/settings.json
# 应该正常输出格式化 JSON

# 4. 看 CC 日志
claude --debug 2>&1 | grep -i hook

# 查看状态文件
cat /tmp/req-state.json

# 手动重置
rm /tmp/req-state.json