# 普通无头：会吸收本地一切配置，不可复现
claude -p "总结这个项目"

# 裸模式：跳过 hooks/skills/plugins/MCP/auto-memory/CLAUDE.md 的自动发现
claude --bare -p "总结这个项目"

# 把构建报错喂给 Claude，把解释写进文件
cat build-error.txt | claude --bare -p '用一句话指出这个构建错误的根因' > output.txt

// package.json
{
  "scripts": {
    "lint:claude": "git diff main | claude --bare -p \"你是一个错别字检查器。对这段 diff 里每个错别字，第一行输出 文件名:行号，第二行输出问题，其余什么都不要输出。\""
  }
}

# 错误：超大日志可能撑爆 stdin 上限
cat huge.log | claude --bare -p "分析这份日志"

# 正确：引用文件路径，让 Claude 自己按需读取
claude --bare -p "分析 ./huge.log 里最近一小时的 ERROR" --allowedTools "Read,Grep"

claude --bare -p "用三句话总结这个项目的架构" --output-format json > summary.json

{
  "type": "result",
  "subtype": "success",
  "result": "该项目采用分层架构……（正文）",
  "session_id": "abc12340-aaaa-bbbb-cccc",
  "total_cost_usd": 0.0123,
  "usage": { "input_tokens": 2048, "output_tokens": 312, "cache_read_input_tokens": 1024 },
  "duration_ms": 4200,
  "num_turns": 1
}

# 批量跑 10 个仓库，累计总成本
total=0
for repo in repos/*; do
  cost=$(claude --bare -p "审查 $repo 里的安全风险" \
           --output-format json | jq '.total_cost_usd')
  total=$(echo "$total + $cost" | bc)
  echo "$repo 花费 \$$cost，累计 \$$total"
done

claude --bare -p "列出这个仓库所有公开 API 端点" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"}},"required":["method","path"]}}},"required":["endpoints"]}'

claude -n "techdebt-audit-repoA" -p "扫描这个仓库的技术债" --output-format json

# 第一次：跑一个大任务，拿到 session_id
SID=$(claude -n "big-refactor" -p "把所有 class 组件改成函数组件，先做 src/components" \
        --output-format json | jq -r '.session_id')

# 中途断了……接回来继续，带着之前的全部上下文
claude --resume "$SID" -p "继续处理 src/pages 目录" --output-format json

# 把 20 个仓库的路径喂给 xargs，最多 4 路并发
printf '%s\n' repos/* | xargs -I{} -P4 bash -c '
  repo="$1"
  claude --bare -p "审查 $repo 的依赖许可证合规性，输出 JSON" \
    --output-format json > "reports/$(basename $repo).json"
' _ {}

# 给后台 agent 等待封顶设为 5 分钟
export CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=300000

// .claude/settings.json（批处理脚本专用项目配置）
{
  "hooks": {
    "SessionStart": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "echo \"[$(date)] 任务开始 session=$CLAUDE_SESSION_ID\" >> /var/log/batch.log"
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "jq -r '\"任务完成，花费 $\\(.total_cost_usd)\"' >> /var/log/batch.log"
      }]
    }],
    "Notification": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "curl -s -X POST $SLACK_WEBHOOK -d '{\"text\":\"Claude 需要你注意\"}'"
      }]
    }]
  }
}

#!/usr/bin/env bash
# repo-audit.sh —— 批量技术债体检
set -uo pipefail

REPOS_DIR="./repos"
REPORTS_DIR="./reports"
STATE_FILE="./reports/state.tsv"   # 记录 repo -> session_id 的映射，用于续跑
PARALLEL="${PARALLEL:-3}"
MAX_RETRIES=2

mkdir -p "$REPORTS_DIR"
touch "$STATE_FILE"

audit_one() {
  local repo="$1"
  local name
  name=$(basename "$repo")
  local report="$REPORTS_DIR/$name.json"

  # 已有报告则跳过（幂等）
  [[ -f "$report" ]] && { echo "skip $name (已有报告)"; return 0; }

  # 查是否有上次中断的 session_id，有则续跑
  local sid=""
  sid=$(awk -F'\t' -v r="$name" '$1==r{print $2}' "$STATE_FILE")

  local cmd=(-p "扫描这个仓库的技术债：1) 标记所有 TODO/FIXME/HACK 并按严重度分级；
                 2) 找出圈复杂度最高的 5 个函数；3) 输出按季度排期的整改建议。
                 严格按 JSON schema 输出。"
           --output-format json
           --json-schema '{"type":"object","properties":{"todo_count":{"type":"number"},"hotspots":{"type":"array","items":{"type":"string"}},"schedule":{"type":"array","items":{"type":"object","properties":{"quarter":{"type":"string"},"item":{"type":"string"}}}}},"required":["todo_count","hotspots","schedule"]}'
           --allowedTools "Read,Grep,Glob")

  if [[ -n "$sid" ]]; then
    cmd=(--resume "$sid" "${cmd[@]}")
  fi

  # 带超时与重试
  local attempt=0
  while [[ $attempt -le $MAX_RETRIES ]]; do
    attempt=$((attempt+1))
    if timeout 600 claude --bare "${cmd[@]}" > "$report.tmp" 2>"$report.err"; then
      # 成功：记录 session_id 以备未来续跑，落正式报告
      local new_sid
      new_sid=$(jq -r '.session_id // empty' "$report.tmp")
      [[ -n "$new_sid" ]] && sed -i "/^$name\t/d" "$STATE_FILE" && printf "%s\t%s\n" "$name" "$new_sid" >> "$STATE_FILE"
      mv "$report.tmp" "$report"
      local cost
      cost=$(jq -r '.total_cost_usd // 0' "$report")
      echo "ok $name (成本 \$$cost)"
      return 0
    fi
    echo "retry $name (第 $attempt 次)" >&2
    sleep 5
  done
  echo "FAIL $name" >&2
  return 1
}
export -f audit_one
export REPORTS_DIR STATE_FILE MAX_RETRIES

# 并发跑
printf '%s\n' "$REPOS_DIR"/* | xargs -I{} -P"$PARALLEL" bash -c 'audit_one "$@"' _ {}

# 聚合：总成本、高危项 top、失败清单
echo "===== 汇总 ====="
echo "总成本: \$$(jq -s '[.[].total_cost_usd] | add' "$REPORTS_DIR"/*.json 2>/dev/null | bc)"
echo "失败仓库: $(comm -23 <(ls "$REPOS_DIR" | sort) <(ls "$REPORTS_DIR" | sed 's/\.json$//' | sort) | tr '\n' ' ')"
echo "全局高危热点 top10:"
jq -s '[.[].result // .[] | .hotspots[]?] | flatten | .[]' "$REPORTS_DIR"/*.json 2>/dev/null | sort | uniq -c | sort -rn | head

flowchart TD
    A[repos/ 下 N 个仓库] --> B{xargs -P 并发分发}
    B -->|worker 1| C1[查 state.tsv 是否有 session_id]
    B -->|worker 2| C2[查 state.tsv 是否有 session_id]
    B -->|worker 3| C3[查 state.tsv 是否有 session_id]
    C1 --> D1{有历史 session?}
    C2 --> D2{有历史 session?}
    C3 --> D3{有历史 session?}
    D1 -->|是| E1[--resume SID 续跑]
    D1 -->|否| F1[全新 --bare -p 调用]
    D2 -->|是| E2[--resume SID 续跑]
    D2 -->|否| F2[全新 --bare -p 调用]
    D3 -->|是| E3[--resume SID 续跑]
    D3 -->|否| F3[全新 --bare -p 调用]
    E1 & F1 & E2 & F2 & E3 & F3 --> G[timeout 600 + --json-schema 约束]
    G --> H{退出码 0?}
    H -->|否, 重试≤2| G
    H -->|是| I[写 reports/name.json 记 session_id 到 state.tsv]
    H -->|超次失败| J[记入失败清单]
    I --> K[jq -s 聚合总成本与高危热点]
    J --> K
    K --> L[输出汇总报告]

    style B fill:#e1f5ff
    style G fill:#fff3e0
    style K fill:#e8f5e9