CodeBuddy子代理需置于.codebuddy/agents/或~/.codebuddy/agents/路径下，以.md文件形式存在，通过YAML Frontmatter声明name、description、tools等字段，支持手动斜杠调用或主代理自动委派。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy子代理（Sub-Agents）是把特定任务封装成可复用“智能体工具”的核心机制，它不是独立运行的AI，而是按需激活、专注单一职责的轻量级助手。使用关键在于位置规范、元数据声明和调用方式三者配合。
子代理文件怎么放才有效
子代理必须放在两个固定路径之一，系统才会自动识别：
-
项目级：在当前项目根目录下创建
.codebuddy/agents/目录，所有.md文件即为子代理（如.codebuddy/agents/code-review.md注册为code-review） -
全局级：在用户主目录下建
~/.codebuddy/agents/，适合跨项目复用的通用能力（比如统一的 PR 模板生成器） - 支持子目录嵌套，例如
~/.codebuddy/agents/debug/trace.md会被识别为trace，来源标签自动标记为(user:debug) - 文件名即默认名称，也可在 Frontmatter 中用
name字段覆盖
Frontmatter 配置要写哪些字段
每个子代理 Markdown 文件顶部需有 YAML Frontmatter，至少包含角色定义和行为约束：
-
name：可选，用于覆盖文件名；建议保持简洁，如"log-diagnoser" -
description：必填语义描述，说明它能做什么，例如"根据堆栈日志定位异常行并推荐修复" -
tools：明确列出所需工具，用逗号分隔，如"fs,github,bash"；不声明则继承主代理默认工具集 -
model：可选，指定模型（如"sonnet"），但实际调度由上层策略决定 -
color：可选十六进制色值，用于 UI 区分，如"#2563EB"
Frontmatter 后的正文是它的系统指令，要写清楚输入格式、处理步骤和输出结构。例如：“你收到一段含 at 行的 Java 堆栈日志，先提取文件路径和行号，再打开对应源码上下文，最后给出空指针校验补丁。”
CodeBuddy VS Code插件
CodeBuddy VS Code插件下载入口，整理CodeBuddy腾讯云代码助手的官方插件地址、安装入口和基础功能说明。
下载
怎么调用子代理
有两种主流方式，适用不同场景：
-
手动触发：在 CLI 或 Chat 界面输入斜杠命令
/agents打开管理界面，点击目标子代理卡片即可启动；或直接输入/agent name（如/agent code-review） -
自动调用：主代理在任务分解中识别到匹配需求（如“检查这段代码是否符合安全规范”），会自动委派给已注册的
code-review子代理执行 -
作为工具嵌入其他流程：在 Craft 模式或 Plan 模式中，子代理可被声明为
asTool: true的组件，供更复杂工作流调用
常见问题与验证方法
如果子代理没出现或不响应，优先检查以下几点：
- 路径是否严格为
.codebuddy/agents/或~/.codebuddy/agents/（注意点号开头、大小写） - 文件是否以
.md结尾，且 Frontmatter 语法正确（用三个短横线包裹，缩进一致） - 执行
/agents后是否能看到该代理条目，右侧显示来源标签（如(project)） - 尝试用
/agent xxx测试调用，观察是否进入交互流程而非报错“未找到”
子代理本质是职责隔离的协作单元，不是越多越好，建议从高频重复任务切入，比如日志诊断、PR 描述生成、接口契约校验——一个清晰命名、职责单一的子代理，比五个模糊功能的更可靠。
