用途:该技能提供在 Gemini CLI 中创建自定义子代理(专家代理)的说明,当用户想新建一个专职代理时触发。
主要能力:子代理以 Markdown 文件(.md)加 YAML frontmatter 定义,文件正文即该代理的 System Prompt,定义后可作为工具被调用。
存放位置:项目级为 .gemini/agents/.md(可通过 git 与团队共享);用户级为 ~/.gemini/agents/.md(个人代理,所有会话可用)。
文件格式:必须以 YAML frontmatter 开头,其中 name(唯一 slug,仅含 a-z、0-9、-、_)和 description 为必填;description 供主代理判断何时调用该子代理。可配置 kind、tools、model、temperature、max_turns 等字段。
配置:需在项目或用户的 .gemini/settings.json 中启用子代理:{"experimental": {"enableAgents": true}}。
激活:创建或修改子代理文件后,必须提示用户在 CLI 中运行 /agents refresh 以加载新定义。
使用与委派:刷新后子代理以与其 name 匹配的工具形式可用,可将复杂、重复或高量任务委派给它;子代理返回工作摘要,从而保持主会话上下文干净聚焦。
限制:资料未提供更多关于模型兼容性、权限边界或错误处理的细节。