Caliber

手写的 CLAUDE.md 文件在你重构的那一刻起就过时了。 AI Agent 经常会产生幻觉，引用不存在的路径、遗漏新的依赖，并基于过时的架构给出建议。Caliber 能够自动生成并维护你的 AI 上下文文件（CLAUDE.md、.cursor/rules/、AGENTS.md、copilot-instructions.md），确保它们随着代码的演进而保持准确。无论你的团队使用 Claude Code、Cursor、Codex、OpenCode 还是 GitHub Copilot，Caliber 都能让所有 Agent 保持同步。

前后对比

大多数代码仓库仅有一个手写的 CLAUDE.md，除此之外别无他物。以下是 Caliber 的检测与修复成果：

  优化前                                    优化后 /setup-caliber
  ──────────────────────────────            ──────────────────────────────

  Agent Config Score    35 / 100            Agent Config Score    94 / 100
  等级 D                                    等级 A

  FILES & SETUP           6 / 25            FILES & SETUP          24 / 25
  QUALITY                12 / 25            QUALITY                22 / 25
  GROUNDING               7 / 20            GROUNDING              19 / 20
  ACCURACY                5 / 15            ACCURACY               13 / 15
  FRESHNESS               5 / 10            FRESHNESS              10 / 10
  BONUS                   0 / 5             BONUS                   5 / 5

评分过程是确定性的——不涉及 LLM，无需 API 调用。它通过对比你的配置文件与实际的项目文件系统来进行交叉验证：引用路径是否存在？代码块是否完整？自上次提交以来配置是否有偏差？

caliber score --compare main    # 查看当前分支相比主分支的评分变化

快速开始

要求 Node.js >= 20。

npx @rely-ai/caliber bootstrap

然后，在你的终端（非 IDE 聊天窗口）中启动 Claude Code 或 Cursor CLI 会话，并输入：

/setup-caliber

你的 Agent 将会自动检测技术栈、为团队所使用的每个平台生成量身定制的配置、设置 pre-commit hooks，并启用持续同步——这一切都在你日常的工作流中自动完成。

不使用 Claude Code 或 Cursor？ 请运行 caliber init —— 它同样提供命令行向导。支持任何 LLM 提供商：只需使用你自己的 Anthropic、OpenAI 或 Vertex AI Key。

你的代码留在你的机器上。 Bootstrap 过程 100% 本地化——没有 LLM 调用，不会向任何地方发送代码。配置生成过程完全使用你自己的 AI 订阅或 API Key。Caliber 永远不会读取你的代码。

Windows 用户注意事项

Caliber 在 Windows 上运行，请注意以下几点：

• 请通过终端运行（PowerShell、CMD 或 Git Bash），不要在 IDE 的聊天窗口中运行。打开终端，cd 进入项目文件夹，然后运行 npx @rely-ai/caliber bootstrap。
• 推荐使用 Git Bash。Caliber 的 pre-commit hooks 和自动同步脚本使用 Shell 语法。Git for Windows 包含 Git Bash，可以自动处理这些语法。如果你仅使用 PowerShell，hooks 可能会被静默跳过。
• Cursor Agent CLI：如果系统提示安装，请从 cursor.com/downloads 下载，而不是使用 macOS/Linux 上显示的 curl | bash 命令。然后，在终端运行 agent login 进行身份验证。
• 同一时间仅使用一个终端。避免同时在多个终端运行 Caliber，这可能导致状态冲突或错误的提供商检测。

先审计，后写入

Caliber 绝不会在不经询问的情况下覆盖你的现有配置。其工作流模拟了代码审查流程：

1. 评分 (Score) — 对当前配置进行只读审计
2. 提议 (Propose) — 生成或优化配置，以 diff 形式展示
3. 审查 (Review) — 接受、通过聊天细化，或拒绝每一项更改
4. 备份 (Backup) — 每次写入前将原文件保存至 .caliber/backups/
5. 撤销 (Undo) — 使用 caliber undo 将一切恢复到上一个状态

如果你的现有配置评分达到 95+，Caliber 将跳过全量生成，仅针对未通过的检查项进行定向修复。

工作原理

Bootstrap 会为你的 Agent 赋予 /setup-caliber 技能。Agent 将分析你的项目（语言、框架、依赖、架构）、生成配置并安装 hooks。此后，它便进入循环工作模式：

  npx @rely-ai/caliber bootstrap       ← 一次性设置，仅需 2 秒
              │
              ▼
  agent 运行 /setup-caliber             ← Agent 处理一切事务
              │
              ▼
  ┌──── 配置已生成 ◄────────────┐
  │           │                        │
  │           ▼                        │
  │     代码发生演进 (如：               │
  │     新依赖、文件重命名、             │
  │      架构变更)                     │
  │           │                        │
  │           ▼                        │
  └──► caliber refresh ──────────────►─┘
       (在每次提交时自动运行)

Pre-commit hooks 会自动运行刷新循环。团队新成员在首次会话时也会被引导进行 bootstrap。

生成的内容

Claude Code

• CLAUDE.md — 项目上下文、构建/测试命令、架构、规范。