用 AI 做出第一个项目 · 第 4 章
给 Agent 接上外脑:SuperBrain
把知识库挂到 Agent 上,让它回答时能查到你的资料而不是凭记忆编。这篇讲外脑的接法与适用边界。
给 Agent 接上外脑:SuperBrain
当你的电脑上同时装着 Claude、Codex、Kimi、Qoder CN 等命令行工具时,问题就不再是「有没有 AI」,而是怎么把它们接进同一套能长期用下去的工作流:谁来调度、提示词怎么传、输出格式变了怎么办、后续怎么维护。这些细节凑在一起,就是一层需要单独处理的连接与协作。
SuperBrain 处理的正是这一层——它负责宿主 Agent 与外部 CLI 之间的连接与协作,而不是再造一个模型。要判断它对你有没有用,先看两个最直接的问题:能装在哪、能叫谁。
Skill 获取地址:https://github.com/Niall-Young/SuperBrain
能装在哪、能叫谁
SuperBrain 是一个需要你显式调用的 Agent Skill,宿主 Agent 至少需要具备 Skill 与子智能体能力,是否兼容仍需按宿主的实际能力确认;项目说明以 Claude Code 为示例宿主,并在安装说明里列出了 Cursor、Windsurf、Codex 等宿主对应的 skills 目录——注意,这些是示例和目录说明,并未逐一做过兼容性实测。能叫谁:本次源码包内置了四个外脑 CLI 席位——Claude、Codex、Kimi、Qoder CN。一句话概括它的价值:它把「外接 AI」做成了一层可配置、可维护的东西,而不是一次性演示。下面把「装在哪」和「叫谁」分开讲,因为它们是两层不同的事。
两层接入:宿主与外脑
SuperBrain 的接入分两层,这是全文最容易混、也最值得先分清的地方。
上层是宿主 Agent:负责承载 Skill、显式调用流程并整合结果,需要具备 Skill 与子智能体两种能力。下层是外脑 CLI:充当圆桌上的席位,每个席位是一个已安装的命令行工具,负责独立作答。两层的接入方式和验证方式完全不同——宿主看的是能力,外脑看的是工具装没装、能不能被找到、输出能不能被解析。
容易混的原因在于名字会串层:项目说明既拿 Claude Code 当宿主示例,又把 Codex 同时列为宿主之一和默认外脑席位。同一个名字出现在两层,不意味着「这个宿主绑定这个外脑」。判断之前,先想清楚这句话说的是哪一层。
接入矩阵
把两层落成一张表,你可以直接截图带走。表中「默认还是示例」区分出厂名单与举例说明;「验证方式」告诉你靠什么确认可用;「表述边界」是要一起记住的限定条件。
| 名称 | 所在层 | 默认还是示例 | 提示词传输 | 输出格式 | 验证方式 | 表述边界 |
|---|---|---|---|---|---|---|
| Claude Code | 宿主 Agent | README 示例宿主 | 不适用 | 不适用 | 需具备 Skill 与子智能体能力 | 示例宿主,未逐一实测兼容 |
| Cursor、Windsurf、Codex 等宿主 | 宿主 Agent | 安装说明列出的对应 skills 目录 | 不适用 | 不适用 | 同上 | 仅目录有说明,不等于已验证兼容 |
| Claude CLI(claude) | 外脑 CLI 席位 | 内置默认席位之一 | stdin | claude-json | 本地自检仅确认可执行文件与版本,不验证登录与额度 | 本次源码包内置默认映射,非永久接口承诺;默认支持不等于本机可用 |
| Codex CLI(codex) | 外脑 CLI 席位 | 内置默认席位之一 | stdin | codex-jsonl | 同上 | 同上;此处指外脑席位,与作为宿主的 Codex 不是一回事 |
| Kimi CLI(kimi) | 外脑 CLI 席位 | 内置默认席位之一 | argv | kimi-jsonl | 同上 | 同上 |
| Qoder CN CLI(qoderclicn) | 外脑 CLI 席位 | 内置默认席位之一 | argv | claude-json | 同上 | 同上;复用 claude-json 是项目配置事实,不按名称推测 |
| 你自己的 CLI | 外脑 CLI 席位 | 通过 JSON 配置整体覆盖 | 仅 stdin、argv 两种 | 仅 text、claude-json、codex-jsonl、kimi-jsonl 四种 | 配置校验+本地自检+单元测试+一次低风险真实咨询 | 只有符合现有传输与解析契约的 CLI 能仅靠 JSON 接入,不是零代码即 |
做出来了,下一步:登记
项目能跑只是前半程。源码文档整理、申报材料生成这类重复劳动,可以交给软著通——AI 软件著作权申请工具,材料备齐再提交;登记结果以中国版权保护中心审核为准。