Routines 是 Claude Code Week 16（4 月 13 日）推出的云端定时 Agent 功能，让你能定义一次任务，然后由时间表、GitHub 事件或 API 调用自动触发执行——你的机器不需要在线。
什么是 Routines？
Routines = 云端运行的 Claude Code Agent + 触发器
你定义：
- 提示词：Agent 每次触发时要做什么
- 仓库：Agent 可以访问哪些代码库
- 连接器：需要哪些集成（GitHub、Slack 等）
- 触发器：什么时候/什么事件触发
Anthropic 的云基础设施负责实际运行，你不需要本地开发环境在线。
创建 Routine
通过网页 UI
- 打开
claude.ai/code - 找到 Routines 入口 → New Routine
- 填写：名称、提示词、仓库、连接器、触发器
通过 CLI
bash
> /schedule daily PR review at 9am
> /schedule weekly dependency audit every Monday 10am
> /routines list # 查看所有 Routines
> /routines fire "Daily PR Review" # 手动触发三种触发方式
1. 时间表触发（Cron）
# 每天早上 9 点（北京时间 = UTC+1 = 01:00 UTC）
cron: "0 1 * * *"
# 每周一早上 10 点
cron: "0 2 * * MON"
# 工作日每天运行
cron: "0 1 * * MON-FRI"
2. GitHub 事件触发
支持的事件（带可选过滤器）：
| 事件 | 说明 |
|---|---|
pull_request.opened | PR 创建时 |
pull_request.synchronize | PR 有新 push 时 |
push（branch: main） | push 到 main 时 |
release.published | Release 发布时 |
workflow_run.completed（failure） | CI 失败时 |
issues.opened | Issue 创建时 |
3. API（Webhook）触发
每个 Routine 有唯一的带 Token 的 /fire 端点：
bash
curl -X POST "https://api.claude.ai/routines/ROUTINE_ID/fire" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"context": "deploy triggered by release v2.1.0"}'6 个实用 Routine 模板
模板 1：每日代码健康检查
名称：Daily Health Check
触发：每天早上 9:00
提示词：
检查 main 分支过去 24 小时的提交：
1. 有没有直接 push 到 main 的（应该走 PR）
2. 有没有超过 500 行的大型提交
3. 有没有新增 TODO/FIXME 注释
4. 有没有修改 .env 相关文件
以 Markdown 格式发送报告到 Slack #dev-reports 频道
模板 2：PR 创建时自动审查
名称：PR Auto Review
触发：pull_request.opened（target: main 或 develop）
提示词：
对刚创建的 PR 进行初步审查：
1. 代码质量（命名、复杂度、可读性）
2. 安全性（输入验证、SQL 注入、XSS）
3. 测试覆盖（是否有对应测试）
4. 文档（是否需要更新文档）
以友好 PR 评论发布。发现严重问题加 🚨，代码很好加 ✅。
模板 3：CI 失败自动分析
名称：CI Failure Analyzer
触发：workflow_run.completed（failure）
提示词：
CI 在 {{branch}} 失败了。分析：
1. 拉取失败日志
2. 识别失败的测试或构建步骤
3. 查看相关代码变更
4. 给出修复方案建议
在关联 PR 里发评论说明分析结果。
模板 4：发版后变更日志生成
名称：Release Changelog
触发：release.published
提示词：
基于本次 Release 的所有 commits：
1. 分类为新功能/Bug 修复/性能改进/破坏性变更
2. 用用户友好的语言描述每项变更
3. 更新仓库里的 CHANGELOG.md
4. 发消息到 Slack #releases 频道
模板 5：每周依赖安全扫描
名称：Dependency Security Scan
触发：每周一早上 8:00
提示词：
扫描 package.json 依赖：
1. 运行 npm audit，检查已知 CVE 漏洞
2. 找出超过 6 个月未更新的包
3. 检查非 MIT 许可证
Critical/High 漏洞立即发 Slack @channel 消息
否则发周报到 #security 频道
模板 6：Issue 智能分类
名称：Issue Triage
触发：issues.opened
提示词：
对新 Issue 进行分类：
1. 添加标签（bug/feature/docs/question）
2. 评估优先级（P0/P1/P2/P3）
3. 如果是 Bug，找到相关代码文件
4. 信息不足时评论请求更多信息
5. 分配给相关领域工程师
监控和调试
查看运行历史
在 claude.ai/code 的 Routines 面板里看：
- 每次运行状态（成功/失败）
- 运行时间和 Token 消耗
- 完整的 Agent 执行日志
常见问题
Routine 没有触发：
- 检查 Cron 表达式（注意 UTC 时区）
- GitHub 事件触发需要确认 Webhook 已正确设置
Routine 权限不足：
- 确认已选择正确的仓库
- 检查 GitHub App 权限（读取 PR、发评论等）
运行失败：
- 查看执行日志
- 常见原因：提示词不清晰、缺少必要连接器
来源：Claude Code Routines 官方文档 | Week 16 What's New | 整理：ClaudeEagle