Claude Code Agent 使用

SubAgent格式

  • 文件名:xxx.md(放在 C:\Users\用户名\.claude\agents\ 下面,不需要建子文件夹)
  • 结构:最上面 --- 包裹 YAML 配置,--- 之后是系统提示词
  • 示例
---
name: file-lister
description: 文件扫描子Agent,只查找 .h .cpp 文件,只读,不修改文件
tools: Glob,Read
mode: manual
---
你是文件扫描专员。收到指令后,使用 glob 工具搜索 .h 和 .cpp 文件,输出找到的文件清单。
不要修改任何文件,不要执行危险bash。每一步工具调用前简要说明你要做什么。

重点字段说明

  • name:调用时 @file-lister 用的名字,必须唯一,小写 + 横杠
  • description:描述
  • tools:可选,限定可用工具;不写默认继承主 Agent 全部工具
  • mode:权限模式(manual /acceptEdits/auto /plan),独立于主 Agent
  • --- 下面一大段 = 这个子 Agent 专属 system prompt

 

SubAgent调用

@file-lister 扫描当前目录,列出所有 .h 和 .cpp 文件

执行流程

  1. 主 Agent 识别 @file-lister,唤起这个子 Agent
  2. 子 Agent 拿到它自己独立的提示词、工具白名单、manual 权限
  3. 它想要调用 Glob → 弹窗 Allow? [y/n]
  4. 输入 y 放行,拿到文件列表,整理结果返回给主 Agent 展示

image

 

查看可用的subagents

扫描 ~/.claude/agents 和 ./.claude/agents 目录,列出所有 subagent 的名字和简介

image

 

posted on 2026-10-28 17:02  Cynthia_W  阅读(13)  评论(0)    收藏  举报