跳转到主要内容

Skills

Skills 是可复用的 prompt 模块。可以加载 SKILL.md,把面向特定领域的指令添加到会话中。

概览

  • 可以将领域知识作为技能复用
  • 可以在项目之间共享相同的行为
  • 可以按会话切换启用 / 禁用
在 Laravel 版中使用 SessionConfigskillDirectoriesdisabledSkills 进行配置。

基本使用方式

skillDirectories 中指定父目录后,会加载其下每个子目录中的 SKILL.md
也可以用数组形式指定。

禁用技能

使用 disabledSkills 可以只禁用一部分已加载的技能。

目录结构

skillDirectories 中指定像 skills/ 这样的父目录。

SKILL.md 的格式

SKILL.md 是 Markdown,可以选择性附带 YAML frontmatter。
frontmatter 的主要项:
  • name: 技能标识(在 disabledSkills 中指定的名字)
  • description: 技能的简短描述
省略 name 时会使用目录名。

与 Custom Agents 结合

customAgents[].skills 中指定技能名后,当目标代理启动时,会事先加载该技能的内容。
省略 skills 时,代理中不会注入技能内容。

通过 RPC 查看和操作

技能的发现、启用 / 禁用也可以通过 RPC 操作。

最佳实践

  • 按领域拆分技能(如 skills/securityskills/testing
  • 在 frontmatter 中写上 namedescription
  • 有冲突的指令时通过 disabledSkills 显式排除
  • 先单独验证再组合多个技能

参考

最后修改于 2026年7月18日