# 最简单的非交互调用
claude -p "解释 src/index.ts 的入口函数"

# 等价写法
claude --print "解释 src/index.ts 的入口函数"

# 将 git diff 管道给 Claude Code 做 code review
git diff HEAD~3..HEAD | claude -p "审查这些变更，列出潜在问题"

# 将错误日志管道给 Claude Code 分析根因
npm test 2>&1 | claude -p "分析测试失败原因并给出修复建议"

# 将 API 响应管道给 Claude Code 生成类型定义
curl -s https://api.example.com/openapi.json | \
  claude -p "根据这个 OpenAPI 规范生成 TypeScript 类型定义"

# JSON 格式输出
claude -p --output-format json \
  "列出 src/ 目录下所有 API 端点，包含路径、方法、描述"

# 流式 JSON——适合长时间任务
claude -p --output-format stream-json \
  "重构 src/auth.ts 模块"

# 强制 JSON Schema 校验——这是自动化的关键
claude -p \
  --output-format json \
  --json-schema '{
    "type": "object",
    "properties": {
      "title": {"type": "string"},
      "risk": {"type": "string", "enum": ["low", "medium", "high"]},
      "summary": {"type": "string"}
    },
    "required": ["title", "risk", "summary"]
  }' \
  "审查当前 git diff，返回标题、风险等级和摘要"

{
  "title": "Auth middleware bypass vulnerability",
  "risk": "high",
  "summary": "jwt.verify 缺少算法白名单限制，攻击者可通过 alg:none 绕过认证"
}

# 只允许读取，禁止写入——适合 code review 场景
claude -p \
  --allowedTools "Read,Glob,Grep" \
  "审计 src/ 目录的安全问题"

# 允许编辑和 git 操作，禁止网络请求
claude -p \
  --allowedTools "Read,Edit,Bash(git:*)" \
  --disallowedTools "Bash(curl:*)" \
  "修复所有 TypeScript 编译错误并提交"

# 精确控制 Bash 子命令
claude -p \
  --allowedTools "Read,Edit,Bash(npm test:*),Bash(npm run lint:*)" \
  "运行测试并修复所有失败的用例"

# plan 模式：只规划不执行，适合架构评审
claude -p --permission-mode plan "分析这个微服务架构的瓶颈"

# auto 模式：自动处理大部分权限请求，适合受信任的脚本
claude -p --permission-mode auto "清理所有未使用的 import"

# dontAsk 模式：不询问直接执行，仅在沙箱环境中使用
claude -p --permission-mode dontAsk "重构 src/utils/ 目录"

# 恢复最近的会话
claude --continue

# 恢复指定 ID 的会话
claude --resume abc12345-6789-def0-1234-567890abcdef

# 从已有会话分支出新会话——类似 git branch
claude --continue --fork-session

# 项目级（推荐，随代码仓库共享）
.claude/settings.json

# 用户级（对所有项目生效）
~/.claude/settings.json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write 2>/dev/null; exit 0"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'CMD=$(jq -r \".tool_input.command\" <<< \"$(cat)\"); for p in \"rm -rf /\" \"rm -rf ~\" \"drop table\" \"--force\" \"push.*--force\"; do if echo \"$CMD\" | grep -qiE \"$p\"; then echo \"Blocked: $p\" >&2; exit 2; fi; done; exit 0'"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/protect-files.sh
INPUT=$(cat)
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

PROTECTED=(".env" ".env.local" "secrets/" ".git/" "package-lock.json")

for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE" == *"$pattern"* ]]; then
    jq -n --arg f "$FILE" --arg p "$pattern" '{
      hookSpecificOutput: {
        hookEventName: "PreToolUse",
        permissionDecision: "deny",
        permissionDecisionReason: "受保护文件被拦截: \($p)"
      }
    }'
    exit 0
  fi
done
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'jq -r \".tool_input.command\" <<< \"$(cat)\" | while read cmd; do echo \"$(date +%Y-%m-%dT%H:%M:%S) $cmd\" >> \"$CLAUDE_PROJECT_DIR/.claude/command-audit.log\"; done; exit 0'"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/verify-tests.sh
INPUT=$(cat)

# 防止无限循环：如果 hook 已经激活过，直接退出
if [ "$(echo "$INPUT" | jq -r '.stop_hook_active')" = "true" ]; then
  exit 0
fi

# 检查是否有 TypeScript 文件被修改
CHANGED=$(git diff --name-only | grep -c '\.tsx\?$' || true)

if [ "$CHANGED" -gt 0 ]; then
  # 运行类型检查
  if ! npx tsc --noEmit 2>/dev/null; then
    echo "TypeScript 类型检查失败，请修复后再完成"
    exit 2
  fi
fi
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__github__*",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'MCP GitHub tool called' >> /tmp/mcp-audit.log"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "http",
            "url": "https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK",
            "method": "POST",
            "headers": {
              "Content-Type": "application/json"
            }
            }
          }
        ]
      }
    ]
  }
}

---
name: security-auditor
description: 安全审计专家，扫描代码中的 OWASP Top 10 漏洞
model: claude-haiku-4-5
tools:
  - Read
  - Glob
  - Grep
---

你是一位专业的安全审计员。你的任务是：

1. 扫描指定文件或目录中的安全漏洞
2. 按 OWASP Top 10 分类标记问题
3. 给出每个问题的严重等级（Critical/High/Medium/Low）
4. 提供具体的修复建议和代码示例

输出格式：
- 每个问题包含：文件路径、行号、漏洞类型、严重等级、修复建议
- 最后给出整体安全评分（A-F）

# 项目级
.claude/agents/security-auditor.md

# 用户级（所有项目可用）
~/.claude/agents/security-auditor.md

---
name: test-writer
description: 自动编写单元测试
model: claude-sonnet-4-6
allowed-tools:
  - Read
  - Write
  - Glob
  - Grep
  - Bash(npm test:*)
disallowed-tools:
  - Edit
---

# 在 worktree 中运行子 Agent
claude --worktree

# 或在配置中指定

请用 Task 工具并行启动 4 个子 Agent：
1. 读取 auth/ 目录，总结认证模式
2. 读取 api/ 目录，总结路由模式
3. 读取 db/ 目录，总结数据层模式
4. 读取 tests/ 目录，总结测试模式

每个返回 200 字摘要。

为以下 6 个模块各启动一个子 Agent 编写单元测试：
- src/auth/
- src/api/
- src/db/
- src/utils/
- src/middleware/
- src/services/

每个子 Agent 读取对应模块和现有测试模式，然后编写测试文件。

启动 3 个子 Agent 审查这段代码：
1. 安全审计员：检查注入、XSS、CSRF 等安全漏洞
2. 性能分析师：检查 N+1 查询、内存泄漏、不必要的重渲染
3. 可维护性评审：检查命名、复杂度、测试覆盖

每个返回独立评审报告。

# .github/workflows/ai-review.yml
name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: AI Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # 获取 PR 变更范围
          DIFF=$(git diff origin/main...HEAD)

          # 结构化审查
          claude -p \
            --output-format json \
            --json-schema '{
              "type": "object",
              "properties": {
                "issues": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "file": {"type": "string"},
                      "line": {"type": "number"},
                      "severity": {"type": "string"},
                      "message": {"type": "string"}
                    }
                  }
                },
                "summary": {"type": "string"},
                "approved": {"type": "boolean"}
              }
            }' \
            --allowedTools "Read,Glob,Grep" \
            "审查以下变更。以下是 git diff 输出：
            $DIFF

            检查安全漏洞、性能问题、代码风格。
            如果没有严重问题，设置 approved 为 true。" \
            > review_result.json

          # 发布审查结果到 PR
          SUMMARY=$(jq -r '.summary' review_result.json)
          APPROVED=$(jq -r '.approved' review_result.json)

          gh pr comment ${{ github.event.pull_request.number }} \
            --body "## AI Code Review
            $SUMMARY
            **状态**: $([ "$APPROVED" = "true" ] && echo '✅ 通过' || echo '⚠️ 需要关注')"

#!/bin/bash
# scripts/nightly-cleanup.sh

set -euo pipefail

LOG_FILE=".claude/logs/cleanup-$(date +%Y%m%d).log"

claude -p \
  --permission-mode auto \
  --allowedTools "Read,Edit,Bash(npm run lint:*),Bash(git:*)" \
  "执行以下任务：
1. 扫描 src/ 目录中所有未使用的 import 并移除
2. 运行 ESLint --fix 修复所有可自动修复的问题
3. 更新 TypeScript 类型定义中的过期引用
4. 如果有修改，用 'chore: nightly cleanup [skip ci]' 提交
5. 列出所有修改过的文件" \
  2>&1 | tee "$LOG_FILE"

echo "清理完成于 $(date)" >> "$LOG_FILE"

# 每天凌晨 2 点执行
0 2 * * * /path/to/project/scripts/nightly-cleanup.sh

#!/bin/bash
# scripts/generate-docs.sh

# 为每个组件生成 JSDoc 文档
for file in src/components/*.tsx; do
  component_name=$(basename "$file" .tsx)

  echo "处理组件: $component_name"

  claude -p \
    --output-format json \
    --allowedTools "Read,Edit" \
    "为 $file 中的所有导出函数和组件添加 JSDoc 注释。
    遵循以下规则：
    - 每个导出函数必须有 @param、@returns、@example
    - React 组件必须有 Props 类型说明
    - 使用中文注释
    不要修改函数逻辑，只添加注释。" \
    > "docs/component-${component_name}.json"
done

echo "所有组件文档生成完成"

#!/bin/bash
# scripts/auto-fix-tests.sh

# 运行测试
npm test 2>&1 | tee /tmp/test-output.txt
EXIT_CODE=$?

if [ $EXIT_CODE -ne 0 ]; then
  echo "测试失败，启动自动修复..."

  claude -p \
    --permission-mode auto \
    --allowedTools "Read,Edit,Write,Bash(npm test:*)" \
    "以下是测试失败的输出：

$(cat /tmp/test-output.txt)

请：
1. 分析每个失败测试的原因
2. 修复源代码中的 bug（不是修改测试来适应 bug）
3. 重新运行测试验证修复
4. 报告修复了哪些文件以及每个问题的根因"
else
  echo "所有测试通过"
fi

#!/bin/bash
# scripts/triage-bugs.sh
# 自动拉取高优先级 bug，分析并批量修复

set -euo pipefail

# 步骤 1：拉取 bug 列表
ISSUES=$(claude -p \
  --output-format json \
  --allowedTools "Bash(gh:*)" \
  "使用 gh CLI 列出所有 open 的、标记为 bug 和 high-priority 的 issue。
   返回 JSON 数组，每个元素包含：number, title, labels, body 前 200 字符")

echo "发现 $(echo "$ISSUES" | jq 'length') 个高优先级 bug"

# 步骤 2：对每个 bug 启动独立的 worktree 修复
for i in $(seq 0 $(($(echo "$ISSUES" | jq 'length') - 1))); do
  NUMBER=$(echo "$ISSUES" | jq -r ".[$i].number")
  TITLE=$(echo "$ISSUES" | jq -r ".[$i].title")
  BODY=$(echo "$ISSUES" | jq -r ".[$i].body")

  echo "=== 处理 Bug #$NUMBER: $TITLE ==="

  # 在独立 worktree 中修复
  claude -p \
    --permission-mode auto \
    --worktree \
    --allowedTools "Read,Edit,Write,Bash(npm test:*),Bash(git:*)" \
    "你正在修复 GitHub Issue #$NUMBER。

标题：$TITLE
描述：$BODY

步骤：
1. 阅读相关代码，理解 bug 根因
2. 实现修复
3. 运行测试验证
4. 提交到新分支 fix/issue-$NUMBER
5. 返回修复摘要"
done

echo "所有 bug 处理完成"

claude -p \
  --append-system-prompt "在修改生产代码前，必须先编写回归测试" \
  "修复 src/api/auth.ts 中的 JWT 验证 bug"

# 只使用指定的 MCP 服务器，忽略全局配置
claude -p \
  --mcp-config ./mcp.review.json \
  --strict-mcp-config \
  "使用 GitHub MCP 工具审查最近的 PR"

# 同时访问主仓库和共享库
claude -p \
  --add-dir ../shared-lib \
  --add-dir ../design-system \
  "检查主仓库中是否有可以直接使用 shared-lib 中已有实现的重复代码"

# 将调试日志写入文件
claude -p \
  --debug-file ./claude-debug.log \
  "这个自动化任务出了问题"

# 会话结束后检查日志
cat ./claude-debug.log | grep -i error

#!/bin/bash
MAX_RETRIES=3
RETRY=0

while [ $RETRY -lt $MAX_RETRIES ]; do
  if claude -p \
    --permission-mode auto \
    "完成指定任务"; then
    echo "任务成功完成"
    exit 0
  fi

  RETRY=$((RETRY + 1))
  echo "第 $RETRY 次尝试失败，重试中..."
  sleep 10
done

echo "任务在 $MAX_RETRIES 次尝试后仍然失败"
exit 1