routemark Skill 技能

Routemark 是把「强模型 + 弱模型」组合成 Controller + Delegate 工作流的命令行工具：让 Claude Code / Codex 当 Controller 写任务、把执行活儿交给 OpenCode / Prime 等更便宜的 coding agent（Delegate）在私有副本里干、Controller 评审结果、只有评审通过的部分才合并进真实仓库。它既不是模型、也不是 harness、更不是服务 —— 是一台机器上的 CLI + 一组给 Controller 读的 skills。

> ⚠️ 当前状态：版本 0.1.0b（beta），已在两位 Mac + Claude Code + Codex + OpenCode + Prime 上跑过真实 provider；v0.1.0 计划在三位真人 walk-through（Mac 上的 Claude Code / Codex、Linux 上的 Claude Code）后发布。 > > ⚠️ 平台限制：open 项目支持 macOS + Linux；sandboxed 项目仅 macOS；Windows 不支持。

核心能力

• Controller + Delegate 双角色架构：Controller（Claude Code / Codex）写任务，Delegate（OpenCode / Prime，跑更便宜的模型）在私有副本执行，Controller 评审，仅通过部分合并。
• 5 大可强制保证（而非「希望模型配合」）：
  • Delegate 工作在私有副本，永不写真实仓库（sandboxed 项目用 macOS sandbox 隔离，Routemark 启动前会校验 sandbox 是否真生效）。
  • 合并的是被评审过的那个 tree（如果分支已动，则把评审 tree apply 到当前分支再核验后才 merge）。
  • 凭据值永不打印；Delegate 引入的凭据问题阻合并（人在终端清除）。
  • 没人评审过的东西不合并（除非你亲自豁免，豁免必须在终端跑）。
  • Controller 隐藏的检查 Delegate 看不到。
• Open / Sandboxed 两模式项目：open 默认 Delegate 以你身份运行、不沙箱（防呆 / 防误操作但防不住主动攻击）；sandboxed 用 macOS sandbox 隔离（防主动攻击）。
• 真实成本可视化：routemark report 与 console 展示 Controller / Delegate 各自 token 消耗（input + output + cache write，独立显示 cache read），按真实 session 文件统计 —— 不估算、不换算成钱。
• 不替代模型选择：不挑模型、不评判厂商，Controller 推荐 + 你决定 + Routemark 记录下次建议。
• Console + Disk + Clean-up：内置只读 console 看等待 / 进行中 / 完成情况；routemark disk 看每个项目占用；routemark clean-up 回收合并后残留。
• 安装链路顺序强约束：必须先 routemark skills install 再开 Controller（Controller 读这批 skills 的本地拷贝）。

安装配置

• 依赖环境：macOS 或 Linux、git、uv（自带 Python）或 pipx（需 Python 3.11+）、已登录 Claude Code / Codex / OpenCode / Prime。
• 安装：uv tool install routemark 或 pipx install routemark；routemark --version 验证版本号（应是 0.1.0b）。
• 关键顺序：先 routemark skills install（刷新 Routemark 的 skills 拷贝，不自动 link 到 Controller），确认无误再 routemark skills install --yes 真正链接进 ~/.claude/skills 或 ~/.codex/skills。安装 / 升级 Routemark 后必须重跑这一步。
• 前置启动 Controller：Routemark 通过 ~/.claude / ~/.codex 检测目标 Controller，所以 skills install 前必须至少开过一次 Claude Code 或 Codex。
• Controller 注册 Delegate：routemark discover 查看本机已装的 Delegate harness、provider、模型；如果还没有，Controller 会在你第一次用时主动问你要不要装 + 你亲自输认证（Routemark 不接触凭据值）。
• 数据目录：默认 ~/.routemark（ROUTEMARK_HOME 可改）；routemark home 打印位置；routemark.toml 放在每个被 add 的项目根。

使用步骤

1. 安装 + 验证：uv tool install routemark，routemark --version 确认 0.1.0b 版本。
2. 前置启动 Controller：至少开过一次 Claude Code（或 Codex），让 ~/.claude / ~/.codex 目录存在。
3. 链接 skills 到 Controller：routemark skills install 看清单 → routemark skills install --yes 实际链接；升级 Routemark 后必须重跑。
4. 查看 Delegate 现状：routemark discover 看本机装了哪些 Delegate harness（OpenCode / Prime）以及各自绑定的 provider / 模型。
5. Controller 发起委派：在 Claude Code 或 Codex 里直接说「用 Routemark 把这个任务委派给 OpenCode：给 README.md 加个简短的 Getting started 段。评审好了合并。」。
6. 观察 Controller 输出：routemark delegate 打印 Run ...、Delegate 完成 open、Controller 评审 + 打印 exactly what would merge；最后 routemark merge 打印 What merged is the tree that was judged:。
7. 管理 / 监控：routemark console 打开只读 console 看等待 / 进行 / 完成；routemark report 看真实 token 消耗（按 Controller / Delegate 分列）；routemark disk 看每个项目占用；routemark clean-up 回收合并后残留。
8. 卸载：routemark skills remove --yes → uv tool uninstall routemark；如果装了 launcher，先 routemark launcher remove。

适用场景

• 多模型协作工作流：Claude Code 写 spec、OpenCode / Prime 跑实现、Controller 评审，把不同模型的能力组合到一条流水线。
• 成本敏感团队：用 Controller（贵但精准）做评审 + Delegate（便宜但量大）做执行，通过 token 报告做 ROI 决策。
• macOS 强安全场景：sandboxed 项目用 macOS sandbox 隔离 Delegate，防主动攻击。
• 可审计 AI 编程：所有 run 记录 + 凭据处理 + 评审轨迹都留底，方便合规 / 安全审计。
• 跨 harness 兼容：同时支持 Claude Code / Codex 当 Controller，OpenCode / Prime 当 Delegate，组合灵活。
• 真实成本可视化：不想被「估算 token 数」糊弄，想看每个 merged task 的真实 Controller / Delegate token 数。
• 远程开发 + 多 worktree：每台机器一份 ~/.routemark，状态完全本地，无云端依赖。

适用人群

• 关注 AI 编程成本 + 评审严谨度的工程 Lead
• 在 Claude Code / Codex / OpenCode / Prime 之间混搭的资深开发者
• 安全敏感团队（要求凭据处理可审计、sandboxed 执行）
• 想用「强模型 + 弱模型」协作模式的人
• macOS 用户（sandboxed 模式仅 macOS）；open 模式兼容 macOS + Linux

工作原理

Routemark 跑在你机器上的 CLI + 给 Controller 读的 skills + 私有 Delegate 副本 + macOS sandbox（可选）四件套。Controller 通过 routemark delegate 把任务交给 Delegate harness（OpenCode / Prime），Delegate 在私有副本工作、Controller 拉回结果 + 自动跑评审脚本（可隐藏）+ 应用 patch。如果分支在分支期间变动，Routemark 把评审 tree 重新 apply 到当前分支、再核验、最后 routemark merge 写入真实仓库。凭据处理中 Delegate 引入的发现会阻合并（人在终端清除）；run 记录、token 消耗、tree sha 全部进 ~/.routemark，routemark console / report / disk 各自从这份本地记录里读真实数据（不估算）。sandboxed 模式启动前 Routemark 会校验 macOS sandbox 是否真生效，确保 Delegate 只能改 Routemark 制造的私有副本。

官方链接

• PyPI 包：https://pypi.org/project/routemark/
• 源码仓库：https://github.com/abhayvc/routemark
• README（含 5 大保证 + 10 分钟首次委派 demo）：https://github.com/abhayvc/routemark#readme
• CHARTER 文档：https://github.com/abhayvc/routemark/blob/main/CHARTER.md
• 许可：Apache 2.0（CLI / loop / sandbox / console 部分），商标「Routemark」归 Saar Inc.