CAPA
用一个 capabilities.yaml 统一管理 AI 编码代理的技能、工具、规则、子代理与 MCP 服务器，并充当本地 MCP 网关，告别分散的代理配置。
证据显示最小权限设计（按子代理过滤 MCP 端点、标记块外科手术式写入、影子工作区）、安装前确认可执行面（install 默认交互确认、--yes 供 CI）、活动追踪中对 secrets 做脱敏、capa upgrade 校验安装器校验和。扣分点：依赖以 ^ 宽范围声明且未见 lockfile/审计证据；registry 适配器是可执行 TypeScript，README 仅提示用户自行审查，缺乏内置校验；回滚能力仅见 capa clean 与 --prune，缺少对已安装 provider 文件的版本化回退说明；维护者身份（infragate）无署名或治理信息。
CLI 语义（init/add/install/sh/wrap）在 README 与速查表中一致，provider 支持与限制（Copilot 不可 wrap、Windows ARM 回退）内部自洽。扣分点：依赖多为 ^ 主版本浮动，Bun 版本固定于 release 工作流但开发侧无锁定证据；失败信息仅有活动面板错误行的描述，未见具体错误消息设计或退出码约定。
受众为团队级 AI 编码代理用户，场景覆盖多 provider、CI、交互模式、Windows/macOS/Linux 及 Windows Developer Mode 限制，均有说明。扣分点：能力边界主要靠 NOTE/TIP 提示，未见对 token 节省 19–40% 以外声明条件的精确说明；触发精度（lazy-load、per-sub-agent 过滤的匹配规则）只有概述无规则文档。
信息架构清晰：Why→Features→Install→Quick start→架构图→cheat sheet→docs/，安装说明覆盖三平台且含校验和与 build-provenance attestation 流程，已知限制（Copilot wrap、Windows ARM/x86）有明示。扣分点：README 引用 MIT 徽章但源文件中未见 LICENSE 文件正文（license 元数据标注 unknown），故 license 仅 1；CHANGELOG 未见（靠 release notes 生成）；维护责任仅有 SECURITY.md 的响应时限，无明确的维护者/路线图承诺。
输出可用性高：命令行工具层（capa sh）、Web UI、dry-run、passthrough 提供多种可核查输出。边际价值明确且真实（统一 35+ provider 配置 + 本地 MCP 网关 + 子代理隔离是同类少见的组合）。扣分点：成本收益中 19–40% token 节省仅一句带 150 trials 的数据，无方法学可核查，且运行本地 server/Web UI 有额外资源与端口（5912）成本未量化。
claim_traceability：token 节省、35+ agent 数量等声明在提供的文件内无法溯源到方法或清单；cross_source_corroboration：测试徽章与 test.yml 被引用但测试代码不在所提供文件中，无法交叉印证；fact_inference_separation：README 区分了事实与提示（NOTE/TIP/IMPORTANT），态度可取，但声明与证据普遍未分离标注，静态审查下仅 1 分。
- 安装器采用 curl | sh 模式，且第三方 registry 适配器为可执行 TypeScript，启用前务必人工审查其来源与代码。
- 首次 install 的可执行面确认是主要的授权关口；CI 中使用 --yes 会跳过确认，请确保 CI 环境中 capabilities.yaml 内容经过评审。
- 19–40% token 节省为项目自述的 150 次试验结果，未经独立验证，不应作为采购依据。
- 依赖使用 ^ 浮动版本，供应链风险需自行评估；建议锁定并审计。
- MIT 徽章存在但源文件集中未见 LICENSE 正文，使用前请核实许可。
这个 Agent 能做什么，适合哪些场景？
CAPA（GitHub: infragate/capa）是一个面向 AI 编码代理的包管理器和 MCP 网关。用户在单个 capabilities.yaml 中声明技能、工具、规则、子代理、hooks 和插件，运行 capa install 后，CAPA 会以各代理的原生格式写入 Cursor、Claude Code、Codex、Windsurf、GitHub Copilot 等 35+ 代理的配置目录。SHA 固定记录在 capabilities.lock 中，标记块写入方式不会覆盖手工编辑的内容。运行时它是一个本地 MCP 网关：所有代理连接同一个本地端点（默认 http://localhost:5912），CAPA 代理上游 stdio/HTTP/SSE 服务器，按需懒加载工具，并按子代理过滤可调用的工具。内置 React Web UI 提供能力编辑、注册表浏览、OAuth 配置和实时活动追踪。支持 macOS、Linux 和 Windows。
工作流从 capa init 开始：创建 capabilities.yaml 并向本地 CAPA 服务器（默认端口 5912）注册项目。用 capa add 添加技能（如 vercel-labs/agent-skills@web-researcher）、MCP 服务器（capa add --server --id brave --cmd npx --arg @brave/brave-search-mcp）或通过注册表搜索（capa registry search skills-sh "research"）。capa install 解析 SHA、填充缓存、写入各代理的原生目录（.cursor/rules/、.claude/agents/、AGENTS.md 等），并把解析结果写入 capabilities.lock。运行时，capa 网关代理所有 MCP 调用：按需加载工具（setup_tools/call_tool）、为每个子代理提供过滤后的端点、通过 ToolCallTracer 记录活动并脱敏密钥。capa sh 把每个已配置工具变成终端命令。capa wrap 在 ~/.capa/workspaces/ 的影子工作区中启动代理，避免 .cursor/、.claude/ 等目录污染真实仓库。插件安装时会克隆仓库并解析 Claude（.claude-plugin/）或 Cursor（.cursor-plugin/）清单，将其中技能、MCP、规则、子代理、hooks 合并进同一安装管线。Web UI 由本地服务器托管，编辑内容通过文件监听实时同步回 capabilities.yaml。
- 团队负责人希望成员克隆仓库即获得一致的代理配置——capabilities.lock 的 SHA 固定保证'明天克隆的人得到和你今天完全相同的设置'。
- 使用多个 AI 编码代理（Cursor、Claude Code、Codex 等）的开发者，想用一份声明式文件替代散落在 CLAUDE.md、.cursor/rules/、AGENTS.md、MCP JSON 中的配置。
- 关注推理成本的团队：按需加载工具而非预载整个工具目录，据称在 claude-opus-4-8 上 150 次试验中减少 19–40% token。
- 担心权限过大的用户：子代理隔离让研究代理的 MCP 端点被过滤，不会继承 git push 之类的危险工具。
- 希望在试用新代理时不污染仓库的开发者：capa wrap 在影子工作区中运行 Cursor、Claude、Codex、Gemini CLI 等。
- 需要审计代理行为的工程师：活动页提供 MCP 调用、shell 工具和代理 span 的实时追踪与时间线。
这个 Agent 有哪些优点和局限？
- 一份 capabilities.yaml 扇出到 35+ 代理的原生目录，配合标记块做外科式写入，不覆盖手工编辑的内容
- capabilities.lock 提供 SHA 固定，保证可复现的代理环境
- 本地 MCP 网关按需懒加载工具，README 称在 150 次试验中减少 19–40% token（claude-opus-4-8）
- 子代理级工具过滤实现权限隔离，研究代理拿不到 git push 等工具
- capa wrap 影子工作区让试用代理不污染真实仓库
- 内嵌 Web UI 支持实时编辑、注册表浏览、OAuth 配置和带密钥脱敏的活动追踪
- GitHub Copilot 尚不可被 wrap：它拥有共享的 .github/ / .vscode/ 目录，需要子路径排除支持
- Windows 上创建影子工作区的符号链接需要开发者模式或提权 shell
- 第三方注册表适配器多为可执行 TypeScript，下载到 ~/.capa/registries-managed/，启用前需审查源码
- capa install 首次运行需要确认可执行面（MCP stdio 服务器、hooks 等），CI 中必须传 --yes
- passthrough 模式跳过锁文件和托管追踪，工具别名、默认值和格式化器仍需托管模式
- GitHub 元数据显示 License: unknown，需自行核实许可证条款后再采用
如何安装或部署这个 Agent？
macOS/Linux：curl -LsSf https://capa.sh/install.sh | sh。Windows：powershell -ExecutionPolicy ByPass -c "irm https://capa.sh/install.ps1 | iex"。安装后进入项目目录运行 capa init，创建 capabilities.yaml 并注册到本地服务器（默认 http://localhost:5912）。
如何使用这个 Agent？
1) capa init 初始化；2) 添加能力：capa add vercel-labs/agent-skills@web-researcher、capa add --server --id brave --cmd npx --arg @brave/brave-search-mcp；3) capa install（CI 中需加 --yes，可用 --dry-run 预览）；4) 用 capa sh brave search --query "…" 直接在终端运行工具；5) capa status 获取 Web UI 地址，在浏览器中编辑并实时同步到 capabilities.yaml；6) 可选 capa wrap cursor/claude/codex 在影子工作区启动代理，capa stop 停止服务器和 wrap 会话。
这个 Agent 与同类方案有什么区别？
README 定位 CAPA 为'AI 编码代理的包管理器和 MCP 网关'，将其与现状对比：配置散落在 CLAUDE.md、.cursor/rules/、AGENTS.md、MCP JSON、hooks 和技能文件夹中且互不匹配。仓库本身未点名其他具体竞品。