用 AI 做出第一个项目 · 第 4 章

给 Agent 接上外脑:SuperBrain

把知识库挂到 Agent 上,让它回答时能查到你的资料而不是凭记忆编。这篇讲外脑的接法与适用边界。

  • 学什么给 Agent 接上外脑:SuperBrain
  • 难度L2
  • 预计时间12 分钟
  • 涉及工具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宿主 AgentREADME 示例宿主不适用不适用需具备 Skill 与子智能体能力示例宿主,未逐一实测兼容
Cursor、Windsurf、Codex 等宿主宿主 Agent安装说明列出的对应 skills 目录不适用不适用同上仅目录有说明,不等于已验证兼容
Claude CLI(claude)外脑 CLI 席位内置默认席位之一stdinclaude-json本地自检仅确认可执行文件与版本,不验证登录与额度本次源码包内置默认映射,非永久接口承诺;默认支持不等于本机可用
Codex CLI(codex)外脑 CLI 席位内置默认席位之一stdincodex-jsonl同上同上;此处指外脑席位,与作为宿主的 Codex 不是一回事
Kimi CLI(kimi)外脑 CLI 席位内置默认席位之一argvkimi-jsonl同上同上
Qoder CN CLI(qoderclicn)外脑 CLI 席位内置默认席位之一argvclaude-json同上同上;复用 claude-json 是项目配置事实,不按名称推测
你自己的 CLI外脑 CLI 席位通过 JSON 配置整体覆盖仅 stdin、argv 两种仅 text、claude-json、codex-jsonl、kimi-jsonl 四种配置校验+本地自检+单元测试+一次低风险真实咨询只有符合现有传输与解析契约的 CLI 能仅靠 JSON 接入,不是零代码即

做出来了,下一步:登记

项目能跑只是前半程。源码文档整理、申报材料生成这类重复劳动,可以交给软著通——AI 软件著作权申请工具,材料备齐再提交;登记结果以中国版权保护中心审核为准。

软著通下载入口