Skills 与子代理
用 SKILL.md 封装可复用能力,用子代理把专门任务委派到独立上下文。
Skills
Skills 像是给 AI 助手的「专业培训」:封装专业知识和最佳实践、提供工作流模板、扩展 AI 能力、在团队里共享(项目级 Skills)。与斜杠命令的区别:斜杠命令由用户主动调用,Skills 由 AI 根据任务需求自动选择。每个 Skill 是一个独立目录,里面有 SKILL.md:项目级放 .codebuddy/skills/,用户级放 ~/.codebuddy/skills/。SKILL.md 用 Markdown 加 YAML frontmatter 定义元数据;内容支持变量占位符(加载或执行时自动替换,同样适用于自定义斜杠命令)、用 !command 语法内联执行 Shell 命令(支持 $ARGUMENTS 替换,@file 引用按大小和 token 上限处理,单个命令失败不影响其他)、声明 Skill 产出的文件(如 pptx、pdf、xlsx 交付物)。/skills 查看当前已加载的所有 Skills(用户级、项目级、插件级)及预估 token 数。
子代理
子代理是 CodeBuddy 可以委派任务的预配置 AI 角色:有特定目的和专业领域、使用与主对话分离的独立上下文窗口、可限定可用工具、带自定义系统提示。遇到匹配其专长的任务时,CodeBuddy 可以自动委派。创建:打开 /agents 界面,选「创建新代理」,推荐先用 AI 生成再自定义,详细描述何时应使用它,选择授予的工具(留空则继承全部)。存储为带 YAML 前置内容的 Markdown 文件:项目子代理在 .codebuddy/agents/(优先级最高),用户子代理在 ~/.codebuddy/agents/;名称冲突时项目级优先。插件也能提供子代理,与自定义代理一起显示在 /agents 里,可以显式调用(「使用 security-plugin 中的 code-reviewer 代理」)。还可用 --agents 命令行参数以 JSON 动态定义会话级子代理。进阶能力见官方「Agent Teams」。