graph TD
    A[定时任务需求] --> B{需要 GUI 操作?}
    B -->|否| C{需要跨会话持久化?}
    B -->|是| D[Computer Use + /loop]
    C -->|否| E["/loop 会话内调度"]
    C -->|是| F["cron + headless 模式"]
    E --> G[构建监控<br/>PR 审查提醒<br/>Issue 分诊]
    F --> H[安全扫描<br/>夜间部署检查<br/>日报生成]
    D --> I[测试 Native App<br/>GUI 工具自动化<br/>截图回归测试]

    style A fill:#1a1a2e,color:#fff
    style D fill:#e94560,color:#fff
    style E fill:#0f3460,color:#fff
    style F fill:#16213e,color:#fff

# 基本语法
/loop <间隔> "<prompt>"

# 示例：每 5 分钟检查构建状态
/loop 5m "check if the Vite build succeeded and summarize new errors"

# 每 15 分钟执行代码审查
/loop 15m "review changed files and queue review notes"

# 每 30 分钟分诊 GitHub Issues
/loop 30m "check for new GitHub issues, label them, add a proposed resolution comment"

# 在 Claude Code 会话中执行
/loop 5m "检查以下内容并给出状态摘要：
1. git status 是否有未提交的更改
2. npm test 最近一次运行结果
3. 当前分支是否有未合并的 PR
4. 磁盘使用是否超过 80%
如果有异常，用 ⚠️ 标记；如果一切正常，用 ✅ 标记"

📋 状态巡检 [2026-05-20 14:35]

✅ Git: clean, 分支 feature/auth
✅ Tests: 142/142 passed
⚠️ PR #347: 等待 review 已超过 24 小时
✅ Disk: 62% used

建议：提醒 @reviewer 查看 PR #347

# 查看所有活跃任务（自然语言）
> "what scheduled tasks do I have?"

# 删除特定任务
> "stop the build monitoring loop"

# 修改间隔
> "change the issue triage loop to every hour"

# 一次性提醒（不是循环）
> "remind me at 3pm to review the API docs"

SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin

# 每晚 02:47 执行安全扫描
47 2 * * * deploy cd /srv/myproject \
  && git pull --ff-only \
  && flock -n /tmp/claude-security.lock claude \
    -p "$(cat ~/prompts/security-sweep.md)" \
    --allowedTools "Bash(git:*),Bash(npm audit),Read,Grep" \
    --max-turns 60 \
    --max-budget-usd 3 \
    --output-format json \
    > /var/log/claude/sweep-$(date +\%F).json \
    2> /var/log/claude/sweep-$(date +\%F).err

# 每 4 小时检查依赖更新
0 */4 * * * deploy cd /srv/myproject \
  && flock -n /tmp/claude-deps.lock claude \
    -p "检查 package.json 中是否有安全更新。如果有，创建一个分支并提交 PR。" \
    --allowedTools "Bash(git:*),Bash(npm:*),Read,Write" \
    --max-turns 30 \
    --max-budget-usd 1.5 \
    --output-format json \
    > /var/log/claude/deps-$(date +\%F-\%H).json \
    2> /var/log/claude/deps-$(date +\%F-\%H).err

claude \
  -p "your prompt here" \        # 非交互模式，直接执行 prompt
  --allowedTools "Bash(git:*),Read,Grep" \  # 白名单工具，限制能力
  --max-turns 60 \               # 最大对话轮次
  --max-budget-usd 3 \           # 单次执行预算上限（美元）
  --output-format json \         # 输出 JSON 格式
  --model claude-sonnet-4-6      # 指定模型（节省成本）

--allowedTools "Bash(git:*),Bash(npm audit),Read,Grep"
# ✅ 允许：git status, git log, git diff
# ✅ 允许：npm audit
# ✅ 允许：Read, Grep（只读操作）
# ❌ 禁止：rm, curl, npm publish, 任何写入操作

你是一个安全巡检助手。请执行以下检查：

1. **依赖漏洞扫描**：运行 npm audit，列出所有 high/critical 级别漏洞
2. **密钥泄露检查**：搜索代码中是否有硬编码的 API key、密码、token
3. **权限审计**：检查最近 7 天的 git log，标记可疑的大范围权限变更
4. **配置漂移**：比较当前 .env.example 和 .env（如果存在），发现新增的敏感配置项

输出格式：
- 每项检查给出 ✅ 通过 或 ⚠️ 发现问题
- 发现的问题给出具体的文件路径和行号
- 最后给出总体安全评分（A-F）
- 如果发现 critical 问题，创建 GitHub Issue 标记为 security

sequenceDiagram
    participant Cron as Cron 调度器
    participant Lock as flock 锁
    participant Claude as Claude Code
    participant Git as Git 仓库
    participant GH as GitHub API

    Cron->>Lock: 获取 /tmp/claude-security.lock
    alt 获取锁成功
        Lock-->>Cron: ✅ 锁定
        Cron->>Git: git pull --ff-only
        Git-->>Cron: 最新代码
        Cron->>Claude: -p "安全巡检..."
        Claude->>Git: npm audit, grep secrets
        Git-->>Claude: 扫描结果
        Claude->>GH: 创建 Issue（如有问题）
        GH-->>Claude: Issue URL
        Claude-->>Cron: JSON 报告
        Cron->>Cron: 写入日期日志
    else 锁已被占用
        Lock-->>Cron: ❌ 跳过本次
    end

1. MCP Server → 优先通过 MCP 工具操作（最精准）
2. Bash 命令  → 通过 shell 执行命令（次优）
3. Computer Use → 通过 GUI 直接操作（最后手段）

# Computer Use 在 Claude Code 中默认关闭，需要手动启用
# 在 Claude Code 会话中输入
> /computer-use enable

# 或在 settings.json 中配置
# ~/.claude/settings.json
{
  "computerUse": {
    "enabled": true,
    "permissions": ["screenshot", "mouse", "keyboard"]
  }
}

# 在 Claude Code 中执行
> 打开 Safari，访问 http://localhost:3000，
> 截图验证首页是否正常加载，
> 然后点击"登录"按钮，
> 输入测试账号 [email protected] / test123，
> 截图确认是否登录成功

# 每 10 分钟检查内部管理后台的健康状态
/loop 10m "打开 Chrome，访问 http://admin.internal:8080/health，
截图查看仪表盘是否显示绿色状态。
如果有红色告警，截图并描述具体异常，
然后发送通知到 Slack #ops 频道。"

graph LR
    A[需要定时任务] --> B{需要 GUI 操作?}
    B -->|是| C[Computer Use + /loop]
    B -->|否| D{会话关闭后仍需运行?}
    D -->|否| E["/loop（会话内）"]
    D -->|是| F{需要多仓库/多任务并发?}
    F -->|否| G["cron + headless"]
    F -->|是| H["GitHub Actions<br/>或 CI/CD 平台"]

    C --> I["示例：GUI 监控<br/>Native App 测试"]
    E --> J["示例：构建监控<br/>PR 审查提醒"]
    G --> K["示例：安全扫描<br/>依赖更新"]
    H --> L["示例：多项目巡检<br/>定时部署"]

    style C fill:#e94560,color:#fff
    style E fill:#0f3460,color:#fff
    style G fill:#16213e,color:#fff
    style H fill:#533483,color:#fff

~/claude-patrol/
├── prompts/
│   ├── security-sweep.md      # 安全巡检 prompt
│   ├── build-monitor.md       # 构建监控 prompt
│   └── gui-health-check.md    # GUI 健康检查 prompt
├── scripts/
│   ├── cron-setup.sh          # Cron 配置脚本
│   └── patrol-report.sh       # 报告汇总脚本
└── config/
    └── patrol.json            # 巡检配置

// config/patrol.json
{
  "project": "my-saas-app",
  "repo": "/srv/my-saas-app",
  "schedules": {
    "security": {
      "cron": "47 2 * * *",
      "budget": 3,
      "maxTurns": 60,
      "tools": ["Bash(git:*)", "Bash(npm audit)", "Read", "Grep"],
      "output": "/var/log/claude/security-{date}.json"
    },
    "deps": {
      "cron": "0 */4 * * *",
      "budget": 1.5,
      "maxTurns": 30,
      "tools": ["Bash(git:*)", "Bash(npm:*)", "Read", "Write"],
      "output": "/var/log/claude/deps-{date}-{hour}.json"
    },
    "gui": {
      "loop": "10m",
      "prompt": "check-gui-health",
      "budget": 0.5,
      "tools": ["computer_screenshot", "computer_mouse", "computer_keyboard"]
    }
  }
}

#!/bin/bash
# scripts/cron-setup.sh

PROJECT_DIR="/srv/my-saas-app"
LOG_DIR="/var/log/claude"
PROMPT_DIR="$HOME/claude-patrol/prompts"

mkdir -p "$LOG_DIR"

cat > /tmp/claude-patrol-cron << EOF
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin

# 安全巡检 - 每晚 02:47
47 2 * * * cd $PROJECT_DIR && git pull --ff-only && \\
  flock -n /tmp/claude-security.lock claude \\
    -p "\$(cat $PROMPT_DIR/security-sweep.md)" \\
    --allowedTools "Bash(git:*),Bash(npm audit),Read,Grep" \\
    --max-turns 60 \\
    --max-budget-usd 3 \\
    --output-format json \\
    > $LOG_DIR/security-\$(date +\%F).json 2>&1

# 依赖更新检查 - 每 4 小时
0 */4 * * * cd $PROJECT_DIR && git pull --ff-only && \\
  flock -n /tmp/claude-deps.lock claude \\
    -p "检查依赖更新，如有安全补丁创建 PR" \\
    --allowedTools "Bash(git:*),Bash(npm:*),Read,Write" \\
    --max-turns 30 \\
    --max-budget-usd 1.5 \\
    --output-format json \\
    > $LOG_DIR/deps-\$(date +\%F-\%H).json 2>&1
EOF

crontab /tmp/claude-patrol-cron
echo "✅ 巡检 cron 已安装"
crontab -l

# 1. 构建状态监控
/loop 5m "检查 Vite 构建是否成功，如果有新错误，列出错误详情和建议修复方案"

# 2. PR 审查提醒
/loop 15m "检查当前分支的 PR 状态。如果有新评论，摘要告诉我。如果等待超过 24 小时未 review，建议我 @相关 reviewer"

# 3. GUI 健康检查（需要 Computer Use）
/loop 10m "打开浏览器访问 http://localhost:3000，截图确认首页加载正常。检查关键元素的可见性和位置是否正确。如果有异常，描述具体问题"

#!/bin/bash
# scripts/patrol-report.sh

DATE=$(date +%F)
LOG_DIR="/var/log/claude"

echo "========== 项目巡检日报 $DATE =========="

# 安全扫描报告
if [ -f "$LOG_DIR/security-$DATE.json" ]; then
  echo ""
  echo "🔒 安全扫描："
  cat "$LOG_DIR/security-$DATE.json" | jq -r '.result // "无结果"' 2>/dev/null | head -20
else
  echo "⚠️ 安全扫描：今日未执行"
fi

# 依赖更新报告
echo ""
echo "📦 依赖检查："
ls -t "$LOG_DIR"/deps-$DATE-*.json 2>/dev/null | head -1 | \
  xargs cat 2>/dev/null | jq -r '.result // "无更新"' 2>/dev/null | head -10

echo ""
echo "============================================="

❌ 不好的 prompt：
"创建一个 Issue 记录这个安全漏洞"

✅ 好的 prompt：
"检查是否已有标记为 security 的 Issue 描述此漏洞。
如果没有，创建一个新的。如果有，更新其状态。"

# 开发阶段：宽松预算，快速迭代
--max-budget-usd 5 --max-turns 100

# 测试阶段：适中预算，验证稳定性
--max-budget-usd 3 --max-turns 60

# 生产阶段：严格预算，确保可控
--max-budget-usd 1.5 --max-turns 30

# 多项目共享 prompt 模板
TEMPLATE_DIR="$HOME/claude-patrol/prompts"

for repo in /srv/project-a /srv/project-b /srv/project-c; do
  PROJECT=$(basename "$repo")
  cd "$repo" && git pull --ff-only && \
  flock -n "/tmp/claude-$PROJECT.lock" claude \
    -p "$(sed "s/{{PROJECT}}/$PROJECT/g" "$TEMPLATE_DIR/patrol.md")" \
    --allowedTools "Bash(git:*),Read,Grep" \
    --max-turns 30 \
    --max-budget-usd 1 \
    --output-format json \
    > "/var/log/claude/$PROJECT-$(date +%F).json" 2>&1 &
done
wait
echo "✅ 所有项目巡检完成"

个人开发者小项目：/loop（够用）
↓ 项目增长
团队项目日常维护：cron + headless（稳定）
↓ 需要更多自动化
企业级持续巡检：GitHub Actions + Cloud Routines

# 检查会话是否活跃
# /loop 依赖活跃的 Claude Code 会话

# 查看当前活跃任务
> "list all active scheduled tasks"

# 检查是否达到 50 个任务上限
> "how many scheduled tasks are running?"

# 检查 cron 日志
grep CRON /var/log/syslog | tail -20

# 手动运行一次测试
cd /srv/myproject && \
  claude -p "测试 prompt" \
    --max-turns 5 \
    --max-budget-usd 0.5 \
    --output-format json

# 检查输出文件
cat /var/log/claude/sweep-$(date +%F).json | jq .

# 检查错误文件
cat /var/log/claude/sweep-$(date +%F).err

# macOS 授权检查
# 系统偏好设置 → 隐私与安全 → 屏幕录制 → 添加 Terminal / Claude
# 系统偏好设置 → 隐私与安全 → 辅助功能 → 添加 Terminal / Claude

# 验证权限
> "take a screenshot"
# 如果报权限错误，检查上述设置