Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

子代理、MCP 与 Hooks

自定义子代理的委派机制与模型策略,用 MCP 安装助手添加 MCP 服务器,以及 SessionStart 等 Hooks 事件。

自定义子代理

子代理用任务专属的指令(定制系统提示、工具限制、模型与技能的使用)扩展主智能体的内置逻辑。当 Junie CLI 遇到与某个子代理名称和描述匹配的任务,就把它委派给该子代理,子代理在自己的上下文里独立工作并把结果返回主智能体。好处:把复杂任务拆成聚焦的单一目的块并让子代理的上下文不进入主对话;通过定义编码标准、清单、流程或要调用的技能来复用行为;用轻量模型处理简单重复任务来优化性能和成本;为特定类型任务强制工具限制(如安全审计和评审时限制为只读)。子代理由 Junie 自动调用并告知用户哪个子代理开始工作;不能像自定义斜杠命令那样手动调用。/settings → Subagents(EAP)选模型选择策略,保存在 ~/.junie/settings.json:SameModelOnly(只在可并行、缩短耗时的独立工作上用子代理,且与主智能体用同一模型)或 Auto(默认,可选更便宜但够用的模型档位)。

MCP

Junie CLI 使用与 JetBrains IDE 里的 Junie 相同的 MCP JSON 配置。/mcp 显示已配置的服务器和 MCP 安装助手:按 Ctrl+A 打开并搜索预配置服务器列表;没有想要的就再按一次 Ctrl+A,助手会搜索官方 MCP 注册表、提示参数、环境变量、密钥或令牌、写入 mcp.json 并验证。选择安装范围:项目范围存到项目根的 .junie/mcp/mcp.json(可提交版本控制共享,注意别把密钥放进去);用户范围存到 ~/.junie/mcp/mcp.json(所有项目可用且仅限你的账号)。连接类型:Remote(HTTP/HTTPS 托管服务器)或 Local(在本机运行,如 npx、Docker、二进制)。需要 OAuth 的远程服务器会显示「Authorization required」,在服务器配置菜单里选 Authorize 并按浏览器页面登录。额外的 MCP 文件夹可用 config.json 的 mcp-locations 指定;在 ACP 客户端里 /mcp 是只读列表。

Hooks(EAP)

Hooks 在 Junie CLI 会话的明确节点自动运行 shell 命令:SessionStart(会话开始时,如启动本地代理、刷新凭证)、UserPromptSubmit(提示发送前校验或补充)等事件,还可检查工具调用和会话结束。在用户 ~/.junie/config.json 或用 --config-location 传入的文件里添加 hooks 对象:

{
  "hooks": {
    "SessionStart": [
      { "matcher": "startup", "hooks": [{ "type": "command", "command": "aws sso login --profile dev", "timeout": 30 }] }
    ]
  }
}

该功能目前处于 Early Access,需安装 EAP 版 Junie CLI;完整事件列表与输入输出见官方 Hooks 页。