infragate/capa

解决的问题

CAPA 通过将分散的配置（如规则、MCP 服务器和技能）集中到一个版本控制的 capabilities.yaml 文件中，简化了 AI 编码代理的管理。它消除了在不同代理（如 Cursor、Claude Code 和 GitHub Copilot）之间手动同步设置的需要，并确保克隆仓库的团队成员通过锁文件获得完全相同的代理配置。

工作原理

CAPA 既是配置管理器，也是运行时网关。它读取一个中心化的 YAML 文件，并将设置“分发”到 35 多种不同 AI 代理所需的原生格式。在运行时，它提供一个本地 MCP（模型上下文协议）网关，将代理的请求代理到上游服务器，支持工具的按需加载以减少 token 使用量，并为子代理隔离提供过滤后的端点。

适用人群

使用多个 AI 编码代理，并希望以标准化、可共享、可版本控制的方式管理这些代理所具备的工具、规则和能力的开发者和团队。

主要亮点

• 统一配置：在 YAML 中编写一次，即可部署到 35 多个代理，包括 Cursor、Claude Code 和 Codex。
• MCP 网关：一个单一的本地端点，可代理 stdio、HTTP 和 SSE 服务器，并支持按需加载工具，以降低推理成本。
• 影子工作区：capa wrap 命令允许在独立工作区中运行代理，防止特定提供方的配置文件污染主仓库。
• 可观测性：包含用于编辑配置的本地 Web UI 和实时活动流，用于追踪 MCP 调用和工具执行。
• 注册表支持：支持浏览并从 Cursor 市场和 Claude 插件等目录中添加技能和插件。