教程

Claude Code Routines 完全指南:10 个开箱即用的 AI 自动化开发任务模板

Claude Code Routines 实战指南:定时触发和事件触发配置语法,10 个开箱即用模板(依赖漏洞扫描/技术债追踪/夜间重构/PR 初审/周报生成等),以及幂等性、错误处理最佳实践。

2026/4/166分钟 阅读ClaudeEagle

Claude Code Routines 是 2026 年 4 月随桌面版重设计一起发布的新功能,目前在研究预览阶段。简单说:它让 Claude Code 能够定时或事件驱动地自动执行任务,且运行在云端,不依赖你的本地机器。

这篇文章专注于如何实际使用 Routines——怎么写、怎么配、有哪些实用模板。


创建 Routine 的基本方式

在 Desktop App 的 Routines 标签页创建,支持两种触发方式:

1. 定时触发(Schedule)

yaml
# Routine 示例:每日代码简报
name: daily-code-digest
trigger:
  type: schedule
  cron: "0 9 * * 1-5"   # 工作日每天 9 点
task: |
  检查 main 分支过去 24 小时的 git log:
  1. 列出提交摘要(作者、改动范围)
  2. 标记出任何可能有风险的改动
  3. 统计测试文件的变更比例
  生成 Markdown 报告发到 Slack #dev-digest 频道

2. 事件触发(Event)

yaml
# Routine 示例:PR 自动初审
name: pr-auto-review
trigger:
  type: event
  event: pull_request.opened
  repo: your-org/your-repo
task: |
  对这个新 PR 做初步审查:
  1. 理解改动目的和范围
  2. 检查是否有明显的逻辑问题或潜在 bug
  3. 验证有无对应的单元测试
  4. 如果改动影响 API,检查是否更新了文档
  把审查意见作为 PR comment 发出,语气友好,标注「AI 初审,供参考」

10 个开箱即用的 Routine 模板

模板 1:依赖漏洞周报

yaml
name: weekly-security-scan
trigger:
  type: schedule
  cron: "0 3 * * 1"   # 每周一凌晨 3 点
task: |
  扫描 package.json(Node.js)和 requirements.txt(Python)中的依赖漏洞:
  - Critical/High:生成告警,列出漏洞名称、影响版本和修复方案
  - Medium/Low:汇总列表
  如果有 Critical 漏洞,立刻发邮件到 security@yourcompany.com
  无论如何都把完整报告保存到 reports/security-YYYY-MM-DD.md

模板 2:技术债务追踪

yaml
name: tech-debt-tracker
trigger:
  type: schedule
  cron: "0 10 * * 5"   # 每周五上午 10 点
task: |
  扫描整个代码库:
  1. 统计 TODO/FIXME/HACK 注释数量,按文件和模块分类
  2. 找出超过 300 行的文件(可能需要拆分)
  3. 找出圈复杂度高的函数(嵌套超过 4 层)
  4. 与上周数据对比,技术债是增加还是减少?
  生成报告到 docs/tech-debt-report.md,并更新 README 里的技术债仪表盘数据

模板 3:文档同步检查

yaml
name: docs-sync-check
trigger:
  type: schedule
  cron: "0 14 * * 3"   # 每周三下午 2 点
task: |
  对比代码和文档:
  1. 检查 src/api/ 下的接口,是否都有对应的 API 文档
  2. 检查 README 里的安装步骤,实际执行一遍验证是否还正确
  3. 找出文档里引用了但代码里已经删除的函数或配置项
  把差异列表生成 Issue 到 GitHub,标签 documentation

模板 4:夜间渐进式重构

yaml
name: nightly-refactor
trigger:
  type: schedule
  cron: "0 23 * * 5"   # 每周五晚 11 点
task: |
  对 src/legacy/ 目录做一次渐进式重构:
  - 遵循 .eslintrc 的规范
  - 每次只改一个文件,不做破坏性变更
  - 每个修改都要保证现有测试通过
  - 生成 PR,标题格式:「chore: refactor legacy/[filename] (automated)」
  如果发现某个文件的改动可能有风险,跳过并在 PR 描述里说明原因

模板 5:Issue 优先级整理

yaml
name: issue-triage
trigger:
  type: schedule
  cron: "0 9 * * 1"   # 每周一早上 9 点
task: |
  处理过去一周新开的 GitHub Issues:
  1. 对每个没有标签的 issue,根据内容打上合适的标签(bug/feature/docs/question)
  2. 重复的 issue 标记为 duplicate 并关联到原 issue
  3. 信息不完整的 issue 评论要求补充(使用 Bug 报告模板)
  4. 生成 issue 周报:新增多少、关闭多少、高优先级有哪些
  发 Slack 到 #product 频道

模板 6:测试覆盖率监控

yaml
name: coverage-monitor
trigger:
  type: event
  event: push
  branch: main
task: |
  每次 main 分支有新提交时:
  运行测试并生成覆盖率报告。
  如果覆盖率比上次提交下降超过 2%,
  在 commit 上发评论警告,并列出未覆盖的新增代码行

模板 7:每日站会准备

yaml
name: standup-prep
trigger:
  type: schedule
  cron: "30 8 * * 1-5"   # 工作日 8:30
task: |
  基于 git log(过去 24 小时)和 GitHub Issues 准备站会素材:
  1. 昨天完成了什么(从 commit message 总结)
  2. 今天计划做什么(从 open issues 和 PRs 推断)
  3. 有无阻塞项(stale PR、长时间未解决的 issue)
  生成 3-5 条简洁要点,发到我的 Telegram

模板 8:API 变更检测

yaml
name: api-change-detector
trigger:
  type: event
  event: pull_request.opened
  path_filter: "src/api/**"
task: |
  这个 PR 涉及 API 改动,检查:
  1. 有无 breaking change(删除字段、改变类型、改变语义)
  2. API 文档是否同步更新
  3. 是否需要版本号升级(semver)
  4. 现有的 API 测试是否覆盖了改动
  在 PR 上留下详细的 API 变更分析评论

模板 9:性能基准追踪

yaml
name: perf-benchmark
trigger:
  type: schedule
  cron: "0 2 * * *"   # 每天凌晨 2 点
task: |
  运行性能基准测试套件(make benchmark):
  1. 记录关键指标:API 响应时间、数据库查询时间、内存使用峰值
  2. 与昨天的数据对比,标记出降幅超过 10% 的指标
  3. 保存结果到 benchmarks/YYYY-MM-DD.json
  4. 如果有明显性能退化,创建 GitHub Issue 并 @cto

模板 10:新成员 Onboarding 助手

yaml
name: new-member-guide
trigger:
  type: event
  event: member_added   # 新成员加入仓库
task: |
  新成员加入了,自动发欢迎邮件并附上:
  1. 仓库结构说明(基于实际目录生成)
  2. 本地开发环境搭建步骤(验证过可执行的)
  3. 常用 make 命令一览
  4. 第一周推荐 review 的代码模块(适合入门的部分)
  5. 联系方式和沟通渠道

最佳实践

1. 给 Routine 加幂等性 Routines 可能因网络问题重跑,写任务时确保重复执行没有副作用(不重复发通知、不重复创建 Issue)。

2. 明确"无结果"时的行为 总是告诉 Routine 没有内容时该怎么办:

  • 「如果没有漏洞,只记录日志,不发通知」
  • 「如果没有需要处理的 Issue,发一条「本周无待处理」到频道」

3. 先小后大 新 Routine 先设置为手动触发测试几次,确认输出符合预期再改为定时/事件触发。

4. 保留审计记录 重要的 Routine(发 PR、创建 Issue)在任务描述里加一句「在操作记录里写明这是 Routine 自动执行的」,方便后续追溯。


来源:Anthropic 官方文档 - Routines | Build Fast with AI 桌面重设计分析 | 整理:ClaudeEagle

相关文章推荐

教程Claude Code 定时任务完整指南:每天自动 review 代码、检查依赖、生成日报Claude Code 定时任务完整配置指南:Desktop 本地任务、云端任务、/loop 三种方式对比,含 5 个实用任务模板(每日代码 review、依赖漏洞扫描、技术债报告),以及权限防卡死和补跑机制详解。2026/4/13教程Claude Code Desktop 定时任务完全指南:自动化每日代码审查、依赖更新和晨报Claude Code Desktop 定时任务完整教程:支持每日代码审查、依赖更新检查、晨报生成等自动化工作流。含三种定时方案对比、配置方法和实用场景示例。2026/4/7教程Claude Code 定时任务(Scheduled Tasks)完全指南:/loop 命令、Cron 表达式与三日自动过期Claude Code 定时任务完整指南:/loop Bundled Skill(三种间隔写法:前置 token/trailing every/默认 10 分钟;对 Skill 命令循环执行)、一次性自然语言提醒(自动删除)、CronCreate/CronList/CronDelete 三个底层工具、运行机制(低优先级/两轮之间触发/本地时区)、随机延迟机制(重复任务 0~10% 偏移/单次任务 90 秒)、三日自动过期、Cron 表达式参考表、CLAUDE_CODE_DISABLE_CRON 禁用,以及会话级局限性(退出消失/无补偿/无持久化)和持久化替代方案(Desktop/GitHub Actions)。2026/3/8教程Claude Code Routines 深度指南:在 CLAUDE.md 中定义团队级可复用工作流Claude Code CLAUDE.md Routines 完整教程:与 Cloud Routines 的区别厘清、10 个真实项目模板(组件脚手架/API 端点/Debug 溯源/安全审查/完整功能实现等),以及团队 Routine 与个人 Routine 的最佳实践。2026/4/17教程Hermes Agent Cron 定时任务完全指南:10 个开箱即用的 AI 自动化任务模板Hermes Agent 定时任务完整教程:自然语言配置 Cron、10 个实用任务模板(AI 资讯简报/GitHub 监控/代码扫描/服务器告警/周报生成等)、标准 Cron 表达式参考和时间守卫防异常补跑。2026/4/15教程Claude Code GitHub Actions 实战:用 @claude 让 AI 自动修 bug、实现功能、生成 PRClaude Code GitHub Actions 实战教程:配置 @claude 命令触发 AI 自动修 bug、实现功能、生成 PR。含 2 步快速配置、3 个工作流示例、安全设置和常见问题排查。2026/4/9