Claude Code Routines云端自动化全实战：从定时触发到Agent View并行管理

npm install -g @anthropic-ai/claude-code@latest
claude --version  # 确认 ≥ 1.0.50
claude auth status  # 确认已登录

graph LR
    A[手动模式] --> B[-p Headless模式]
    B --> C[CI/CD集成]
    C --> D[cron + 本地脚本]

    style A fill:#f9f,stroke:#333
    style D fill:#ff9,stroke:#333

Routine = Prompt（做什么）+ Repo（在哪做）+ Trigger（何时做）+ Connectors（用什么做）

flowchart TD
    A[开始创建Routine] --> B{选择触发类型}
    B -->|定时执行| C[Schedule Trigger]
    B -->|接口调用| D[API Trigger]
    B -->|代码事件| E[GitHub Trigger]

    C --> F[配置cron表达式]
    D --> G[获取Webhook URL]
    E --> H[选择GitHub事件类型]

    F --> I[编写ROUTINE.md]
    G --> I
    H --> I

    I --> J[配置Connectors]
    J --> K[测试运行]
    K --> L[上线监控]

    style A fill:#4CAF50,color:white
    style L fill:#2196F3,color:white

# 进入目标仓库
cd ~/projects/my-api-service

# 创建Routine
claude routine create

? Routine name: daily-code-review
? Description: 每日凌晨审查昨日所有PR，生成审查报告
? Trigger type: Schedule
? Schedule (cron): 0 2 * * *    # 每天UTC凌晨2点
? Repository: my-org/my-api-service
? Branch: main

# Daily Code Review

## 任务
审查过去24小时内合并到main分支的所有Pull Request。

## 检查维度
1. **安全性**：SQL注入、XSS、敏感信息泄露
2. **性能**：N+1查询、内存泄漏风险、大循环优化
3. **代码规范**：TypeScript类型安全、命名一致性
4. **架构一致性**：是否符合项目的分层架构

## 输出
- 在GitHub Issue中创建审查报告
- 标记高风险项为 `security` 标签
- 赋值给对应PR的作者

name: daily-code-review
description: "每日凌晨审查昨日所有PR"
trigger:
  type: schedule
  schedule: "0 2 * * *"    # UTC时间
repository:
  owner: my-org
  name: my-api-service
  branch: main
connectors:
  - github
settings:
  timeout: 30m
  max_turns: 50
  model: claude-sonnet-4-6

# 推送配置到远端
git add .claude/routines/
git commit -m "Add daily code review routine"
git push

# 在CLI中激活
claude routine enable daily-code-review

# 验证状态
claude routine list

┌────────────────────┬──────────┬────────────────┬─────────┐
│ Name               │ Trigger  │ Schedule       │ Status  │
├────────────────────┼──────────┼────────────────┼─────────┤
│ daily-code-review  │ schedule │ 0 2 * * *      │ active  │
└────────────────────┴──────────┴────────────────┴─────────┘

claude routine run daily-code-review --dry-run

claude routine create

? Routine name: security-hotfix
? Description: 收到安全告警后自动分析并生成修复PR
? Trigger type: API
? Repository: my-org/my-api-service

claude routine enable security-hotfix
claude routine webhook security-hotfix

Webhook URL: https://api.claude.com/routines/trigger/sec_xxxxxxxxxxxx
Secret: whsec_xxxxxxxxxxxxxxxx

示例请求:
curl -X POST https://api.claude.com/routines/trigger/sec_xxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: whsec_xxxxxxxxxxxxxxxx" \
  -d '{"alert_type": "CVE-2026-1234", "severity": "critical", "package": "[email protected]"}'

# Security Hotfix Routine

## 输入
Webhook payload中的告警信息。

## 任务
1. 分析CVE详情，判断是否影响本项目
2. 如果影响，检查依赖树找到受影响路径
3. 尝试升级到安全版本
4. 运行测试套件验证兼容性
5. 如果测试通过，创建修复PR
6. 如果升级引入破坏性变更，创建Issue说明风险

## 约束
- 只修改package.json和lock文件
- 不做代码重构
- PR标题格式: [security] fix CVE-XXXX-XXXX

name: Security Alert Handler
on:
  workflow_dispatch:
    inputs:
      alert_type:
        description: 'Alert type (CVE, etc.)'
      severity:
        description: 'Severity level'
      package:
        description: 'Affected package'

jobs:
  trigger-routine:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Claude Security Routine
        run: |
          curl -X POST ${{ secrets.CLAUDE_ROUTINE_WEBHOOK }} \
            -H "Content-Type: application/json" \
            -H "X-Webhook-Secret: ${{ secrets.CLAUDE_WEBHOOK_SECRET }}" \
            -d '{
              "alert_type": "${{ inputs.alert_type }}",
              "severity": "${{ inputs.severity }}",
              "package": "${{ inputs.package }}"
            }'

# PR Auto Review

## 任务
对新打开的Pull Request进行自动审查。

## 检查清单
1. PR描述是否完整（What/Why/How）
2. 是否包含测试变更
3. 代码风格是否与现有代码一致
4. 是否引入新的TODO或FIXME
5. 错误处理是否完善
6. API变更是否有对应的文档更新

## 输出
- 在PR中留下审查评论
- 使用GitHub Review API提交审查
- 严重问题标记为 "Request Changes"
- 小问题标记为 "Comment"

name: pr-auto-review
description: "自动审查新PR"
trigger:
  type: github
  events:
    - pull_request.opened
    - pull_request.synchronize
repository:
  owner: my-org
  name: my-api-service
connectors:
  - github
settings:
  timeout: 15m
  max_turns: 30

graph TB
    subgraph "Claude Code Routine"
        R[Routine核心]
    end

    subgraph "Connectors"
        G[GitHub<br/>PR/Issue/Review]
        S[Slack<br/>消息通知]
        N[Notion<br/>文档更新]
        W[Webhook<br/>自定义HTTP]
        D[Docker<br/>容器操作]
    end

    R --> G
    R --> S
    R --> N
    R --> W
    R --> D

    style R fill:#7C4DFF,color:white
    style G fill:#333,color:white
    style S fill:#4A154B,color:white
    style N fill:#000,color:white

# 首次使用需要授权
claude connector auth github
# 浏览器打开GitHub OAuth页面，授权后自动返回

connectors:
  - github:
      permissions:
        issues: write       # 创建/更新Issue
        pull_requests: write # 创建PR和Review
        contents: write      # 推送代码变更

connectors:
  - github
  - slack:
      channels:
        - "#engineering"
        - "#security-alerts"
      events:
        - on_complete: "✅ Routine {{name}} completed"
        - on_failure: "❌ Routine {{name}} failed: {{error}}"
        - on_pr_created: "🔔 New PR by {{author}}: {{title}}"

# 方式1：直接打开Agent View
claude agents

# 方式2：在活跃会话中按 Ctrl+B 推到后台
# （会话自动进入Agent View）

# 方式3：用/bg命令启动后台会话
claude --bg "重构src/utils目录下的所有工具函数，添加TypeScript泛型"

┌─────────────────────────────────────────────────┐
│  Agent View                           [N]ew [Q] │
├────┬──────────────────┬─────────┬───────────────┤
│ #  │ Session          │ Status  │ Last Activity │
├────┼──────────────────┼─────────┼───────────────┤
│ 1  │ 重构utils        │ running │ 2m ago        │
│ 2  │ 修复auth bug     │ done ✓  │ 5m ago        │
│ 3  │ 添加单元测试      │ waiting │ 1m ago        │
│ 4  │ 依赖更新          │ error ✗ │ 3m ago        │
└────┴──────────────────┴─────────┴───────────────┘
↑↓ 选择  Enter 进入  D 详情  X 终止

sequenceDiagram
    participant U as 开发者
    participant M as 主会话
    participant AV as Agent View
    participant B1 as 后台Session 1
    participant B2 as 后台Session 2

    U->>M: 开始编写feature
    M->>M: 遇到需要大量重构的部分

    Note over M,B1: 按Ctrl+B或输入/bg
    M->>AV: 推当前会话到后台
    AV->>B1: Session 1继续运行

    U->>AV: 查看所有后台会话
    AV-->>U: 显示Session状态列表

    U->>AV: 新建另一个后台任务
    AV->>B2: Session 2开始执行

    Note over B1,B2: 两个Session并行运行

    B1-->>AV: 完成通知
    AV-->>U: Session 1完成

    U->>AV: Enter进入Session 1
    AV->>U: 查看完整对话历史
    U->>M: 继续主会话工作

# 启动主Claude Code会话
claude

> /bg "审查packages/api/src下的所有endpoint，确保每个都有input validation"
> Session pushed to background. Use `claude agents` to monitor.

> /bg "为packages/db/src/migrations目录下的所有migration添加rollback脚本"
> Session pushed to background.

> /bg "更新README.md，添加新的环境变量说明和部署流程"
> Session pushed to background.

┌─────────────────────────────────────────────────────────────┐
│  Agent View                                    [N]ew [Q]uit │
├────┬──────────────────────────────────┬──────────┬──────────┤
│ #  │ Session                          │ Status   │ Activity │
├────┼──────────────────────────────────┼──────────┼──────────┤
│ 1  │ 审查endpoint input validation    │ running  │ 30s ago  │
│ 2  │ 添加migration rollback脚本       │ running  │ 45s ago  │
│ 3  │ 更新README环境变量说明           │ done ✓   │ 10s ago  │
└────┴──────────────────────────────────┴──────────┴──────────┘

> ✅ README.md已更新：
> - 添加了DATABASE_URL环境变量说明
> - 添加了REDIS_URL配置
> - 新增"部署流程"章节
> - 创建了commit: "docs: update env vars and deployment guide"

graph TB
    subgraph "GitHub仓库"
        CODE[源代码]
        PR[Pull Requests]
        ISSUES[Issues]
    end

    subgraph "Claude Code Routines（云端）"
        R1[每日安全扫描<br/>Schedule: 0 3 * * *]
        R2[依赖更新检查<br/>Schedule: 0 5 * * 1]
        R3[PR自动审查<br/>Trigger: PR opened]
        R4[Issue分诊<br/>Trigger: Issue opened]
        R5[安全热修复<br/>Trigger: API webhook]
    end

    subgraph "Agent View（本地）"
        AV[多会话仪表盘]
        S1[Feature开发]
        S2[Bug修复]
        S3[文档编写]
    end

    subgraph "通知"
        SLACK[Slack]
        GH_NOTIF[GitHub通知]
    end

    R1 -->|扫描报告| ISSUES
    R2 -->|更新PR| PR
    R3 -->|审查评论| PR
    R4 -->|标签+赋值| ISSUES
    R5 -->|修复PR| PR

    R1 -->|结果| SLACK
    R5 -->|告警| SLACK

    AV --> S1
    AV --> S2
    AV --> S3

    S1 -->|推送| CODE
    S2 -->|推送| CODE

    style R1 fill:#4CAF50,color:white
    style R2 fill:#2196F3,color:white
    style R3 fill:#FF9800,color:white
    style R4 fill:#9C27B0,color:white
    style R5 fill:#F44336,color:white

# Security Scan Routine

## 任务
扫描项目中所有依赖的安全漏洞。

## 步骤
1. 运行 `npm audit --json` 获取漏洞列表
2. 分析每个漏洞的影响范围和严重程度
3. 检查项目是否实际使用了受影响的代码路径
4. 对 critical/high 级别的漏洞：
   - 尝试自动升级到安全版本
   - 运行测试验证兼容性
   - 如果测试通过，创建修复PR
   - 如果需要breaking change，创建Issue说明
5. 生成安全报告，发布到GitHub Issue和Slack

## 输出格式
- Issue标题: `[Security] Weekly Scan - YYYY-MM-DD`
- 标签: `security`, `automated`
- 包含: 漏洞表格（包名/版本/CVE/严重性/状态）

name: weekly-security-scan
description: "每周安全扫描依赖漏洞"
trigger:
  type: schedule
  schedule: "0 3 * * 1"    # 每周一UTC 3:00
repository:
  owner: my-org
  name: my-api-service
  branch: main
connectors:
  - github:
      permissions:
        issues: write
        pull_requests: write
        contents: write
  - slack:
      channels: ["#security-alerts"]
settings:
  timeout: 45m
  max_turns: 80
  model: claude-sonnet-4-6

# 列出所有Routine
claude routine list

# 查看单个Routine详情
claude routine info daily-code-review

# 手动触发（测试用）
claude routine run daily-code-review

# 查看执行历史
claude routine logs daily-code-review --last 10

# 暂停Routine
claude routine pause daily-code-review

# 恢复Routine
claude routine resume daily-code-review

# 删除Routine
claude routine delete daily-code-review

# 更新Routine配置
claude routine update daily-code-review --schedule "0 4 * * *"

# 不好：两个独立Routine
- schedule: "0 2 * * *"   # 安全扫描
- schedule: "0 3 * * *"   # 依赖检查

# 好：合并为一个Routine
- schedule: "0 2 * * *"   # 安全扫描 + 依赖检查

## Part 1: 安全扫描
（步骤省略）

## Part 2: 依赖检查
（步骤省略）

# 不好：每5分钟轮询
schedule: "*/5 * * * *"

# 好：事件驱动，只在需要时触发
trigger:
  type: github
  events:
    - push    # 只在代码推送时触发

settings:
  timeout: 10m      # 不要设置过长
  max_turns: 30     # 限制交互轮次
  model: claude-sonnet-4-6  # Sonnet比Opus便宜5-10倍

# 查看本月Routine消耗
claude routine usage

# 输出示例：
# ┌────────────────────┬──────────┬─────────┬──────────┐
# │ Routine            │ Runs     │ Tokens  │ Cost     │
# ├────────────────────┼──────────┼─────────┼──────────┤
# │ daily-code-review  │ 22       │ 1.2M    │ $3.40    │
# │ pr-auto-review     │ 45       │ 890K    │ $2.10    │
# │ security-scan      │ 4        │ 2.1M    │ $5.80    │
# ├────────────────────┼──────────┼─────────┼──────────┤
# │ Total              │ 71       │ 4.19M   │ $11.30   │
# │ Quota Remaining    │          │         │ 129 runs │
# └────────────────────┴──────────┴─────────┴──────────┘

# 检查Routine状态
claude routine info <name>

# 查看最近日志
claude routine logs <name> --last 5

# 常见原因：
# 1. GitHub OAuth过期 → claude connector auth github
# 2. 仓库权限不足 → 检查GitHub token scope
# 3. 超过月执行上限 → claude routine usage

# 立即暂停Routine
claude routine pause <name>

# 回滚Routine创建的变更
git revert <routine-commit-hash>

# 检查ROUTINE.md的约束条件是否充分
# 在ROUTINE.md中添加更严格的限制：

## 约束
- 绝对不要修改测试文件之外的文件
- 不要修改package.json的name/version字段
- 不要删除任何现有代码，只能添加

# 检查Session详情
# 在Agent View中按 D 查看详情

# 常见原因：
# 1. 上下文窗口溢出 → 限制工作范围
# 2. 文件冲突 → 避免多Session操作同一文件
# 3. 命令超时 → 检查.bash_timeout设置

# 方式1：使用worktree隔离
claude --bg --worktree "重构auth模块" 
# 自动创建git worktree，完全隔离

# 方式2：在ROUTINE.md中明确文件范围

## 文件范围
只允许修改以下目录：
- src/services/auth/
- tests/auth/

禁止修改：
- src/services/payment/  （另一个Session负责）
- package.json

# [Routine名称]

## 目标
[一句话说明这个Routine要做什么]

## 输入
[描述触发时能获取什么信息]

## 步骤
1. [具体步骤1]
2. [具体步骤2]
3. [具体步骤3]

## 输出
[描述期望的输出：PR/Issue/评论/通知]

## 约束
- [禁止事项1]
- [禁止事项2]
- [边界条件]

## 失败处理
- [如果步骤X失败，应该做什么]

graph LR
    subgraph "云端自动化"
        R[Routine: PR自动审查]
        R2[Routine: Issue分诊]
    end

    subgraph "本地开发"
        AV[Agent View]
        S1[Session: 修bug]
        S2[Session: 写feature]
    end

    R -->|创建Review评论| PR[GitHub PR]
    PR -->|推送修复| S1
    R2 -->|分诊结果| ISSUE[GitHub Issue]
    ISSUE -->|认领任务| S2

    AV --> S1
    AV --> S2

    style R fill:#4CAF50,color:white
    style R2 fill:#9C27B0,color:white
    style AV fill:#FF9800,color:white