Rote Skill:将 Claude Skills 变成确定性生产流水线
Rote Skill:将 Claude Skills 编译成确定性生产流水线的编译工具
Rote 是一个开源 CLI,能够把一个经过验证的 Claude Skill(SKILL.md + references/)编译成类型安全、确定性、可回归测试的生产级流水线。它把 Skill 中固定的逻辑和工具编排移入可审查的代码,只在最需要判断力的步骤才调用模型。一次 10-20 分钟的 Agent 循环,变成一条后台工作流,消耗 token 降至原来的零头,成本从几美元降到几美分,同时支持 Temporal、Cloudflare Workflows、DBOS 等多种运行时引擎。
GitHub:https://github.com/trevhud/rote
功能与原则
Rote 解决的是一个正在大规模发生的问题:Claude Skill 在开发阶段有效,但重复运行到生产环境时就暴露三个缺陷——Token 费用高(每次运行都要重新读取 SKILL.md、工具 schema 和越来越长的对话历史)、延迟高(一个 Agent 循环跑 10-20 分钟作为后台任务不可接受)、结果不确定(”MANDATORY”检查仅靠文字描述,Agent 可以静默跳过)。Rote 的核心原则是把一个 Skill 中真正需要模型判断的部分和确定性部分分开,将后者编译成可直接执行的流水线代码。
认可度
截至 2026-08-29,GitHub 约 6 星(早期项目,ClaudePluginHub 收录时标注 910 星,skills.sh 同期标注 910 星, trending 榜单新晋);在 Claude skills 生态内受关注,理由是它解决的是 Skill 经济规模化后的必答题。近期增长趋势明显,项目于 2026-08-28 在 GitHub trending repos 新增列表出现。
原作者
trevhud(GitHub: trevhud)——专注 AI Agent 工程工具链的独立开发者,旗下还有 rote-graduate、rote-serve、deal-monitor、ops-report 等多个 Skill,涵盖工作流编译、MCP 工具注册、运营报告自动化等场景。
介绍
Rote 的工作分三层,每层职责单一、接口边界清晰。第一层是源代码包(SKILL.md + references/),保持原样不动;第二层是编译器 Agent,它读取源代码包,运行rote-compile Skill,产生一个 runtime-agnostic 的 pipeline.yaml 中间表示(IR),同时吐出提取出的 Python 模块(确定性部分)、LLM-judge 签名(需模型判断部分)、以及目标运行时的可执行代码;第三层是运行时适配器(rote.adapters),负责把 pipeline.yaml IR 转换为 Temporal、Cloudflare Workflows 或 DBOS 的具体代码。
编译的输入是任意一个经过验证的 Claude Skill——只要目录里有 SKILL.md 和可选的 references/,rote 就能处理。以内置的 BDR outreach skill 为例:22 个节点的 IR,其中 78.9%(15/19 非 gate 节点)可编译为确定性的节点,提取出 5 个 Python 模块和 2 个 typed judge 签名,标记了 4 个必检节点和 3 个人工介入门控,整个编译过程约 13 分钟、约 0.70 美元(Sonnet via Claude Code)。
特点
- 把经过验证的 Skill 编译成确定性流水线,Token 费用降至原来的零头,延迟从分钟级降到毫秒级
- 三层架构:源代码包 → pipeline.yaml IR → 目标运行时代码,职责边界清晰,每层可独立演进
- 支持多种运行时引擎:Temporal、Cloudflare Workflows、DBOS,通过可插拔适配器切换
- 编译产物可回归测试:确定性节点输出的代码是字节级一致的,不再有”同一 Skill 每次跑结果不同”的问题
- 内置 MCP 工具注册能力:rote-serve Skill 将编译后的流水线注册为 MCP 工具,Claude 可直接触发部署好的工作流
使用方法
安装(零依赖,Node 18 内置 API):
npx skills add https://github.com/trevhud/rote
在 Claude Code 中编译一个 Skill:
rote compile ./my-skill --runtime dbos --out ./compiled/
不依赖 Claude Code 的零安装方式(使用 uvx):
uvx --from rote-cli rote compile ./my-skill --runtime temporal --out ./compiled/
把编译后的流水线注册为 MCP 工具:
rote register ./compiled/pipeline.yaml
claude mcp add rote ./compiled/rote-mcp
运行效果:编译后,原本 13 分钟的 BDR outreach 流程变成一条可后台执行、毫秒级触发、确定性输出的工作流,Token 消耗从约 0.9M-1.6M cache-read 降到近乎零(只有真正需要判断的节点才调模型)。
使用场景与人群
适用于已经在团队内部积累了多个 Claude Skill、开始将 AI 流程规模化到生产的工程团队;也适合以下场景:需要把 Skill 转成可靠后台任务的开发者(不再接受”Skill 每次跑结果不一样”)、需要在团队内部分发经过验证的标准化流程的 Lead、关注 AI 运行时成本控制的初创公司,以及需要将 AI 工作流与现有 CI/CD 或运维系统集成的 DevOps 工程师。
输入与输出案例
案例 1:编译 BDR outreach Skill
– 输入:rote compile ./examples/bdr-outreach/skill --runtime dbos --out /tmp/bdr-compiled/
– 输出:
– pipeline.yaml:22 节点 DAG,其中 78.9% 为确定性节点
– extracted/:5 个 Python 模块(确定性业务逻辑)
– signatures/:2 个 typed LLM-judge 函数签名
– dbos/:DBOS 运行时可执行代码,可直接部署到生产环境
案例 2:MCP 工具注册(让 Claude 直接触发编译后的流水线)
– 输入:在 Claude Code 中执行 /rote:serve 或命令行 rote register ./compiled/pipeline.yaml && claude mcp add rote ./compiled/rote-mcp
– 输出:编译后的流水线以 MCP 工具形式暴露,Claude 可直接说”运行上周的 BDR 流程”触发,无需每次重新跑 Agent 循环
GitHub: https://github.com/trevhud/rote
评论区
登录后可评论。