caliber-ai-org/ai-setup

它解决了什么问题

Caliber 防止 AI 编码代理使用过时的项目上下文。它解决了手写上下文文件（如 CLAUDE.md 或 .cursor/rules/）在代码重构后变得过时的问题，这会导致 AI 产生幻觉并给出错误的架构建议。

它如何工作

Caliber 在多个平台上自动创建和维护 AI 上下文文件。它分析项目的语言、框架和架构，生成定制的配置文件。它使用确定性评分系统，通过将现有配置与实际文件系统交叉比对，来审核配置质量，确保路径和依赖关系准确无误。

为了保持上下文的实时性，它采用预提交钩子和会话结束触发器，运行 refresh 循环，根据最近的 git diff 更新文档。它还包含一个“会话学习”功能，可在 AI 编码会话期间捕获工具使用情况和修正操作，将这些操作模式提炼为学习文件。

适用于谁

使用 AI 编码代理（如 Claude Code、Cursor、GitHub Copilot、OpenAI Codex 或 OpenCode）的开发者和团队，希望确保其 AI 助手与不断演进的代码库保持同步。

主要特性

• 多代理支持：可同时为 Claude Code、Cursor、GitHub Copilot、Codex 和 OpenCode 生成配置文件。
• 确定性评分：无需调用 LLM 即可审核配置质量与准确性。
• 自动刷新：利用 git 钩子在代码变更时自动更新上下文文件。
• 会话学习：从实际编码会话中学习，记录模式、陷阱和修复方法。
• MCP 服务器发现：自动检测项目工具并配置匹配的 Model Context Protocol (MCP) 服务器。
• 安全工作流：采用先审查后操作的方式，包含 diff 对比、自动备份和完整的撤销命令。