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 CLI for OpenClaw

CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 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 描述生成、接口契约校验——一个清晰命名、职责单一的子代理，比五个模糊功能的更可靠。