关于 Skill

什么是 Skill

Skill 是智能体按需加载的指令单元，包含操作说明、参考文档与执行脚本等。智能体不依赖一个塞满所有信息的巨型系统提示词，而是在推理时按需检索相关 Skill，只加载当前任务真正需要的内容。

Agent Skills 开放标准

Skill 遵循 Agent Skills 开放标准——一种跨工具通用的共享格式。一个 Skill 由一个目录组成，以 SKILL.md 作为入口，并包含可选的附属文件：

my-skill/
├── SKILL.md           # 入口文件 — yaml frontmatter + markdown 指令
├── references/        # 领域文档、API 规范 — 按需加载
│   └── api-docs.md
├── scripts/           # 智能体可执行的脚本
│   └── helper.py
├── examples/          # 展示预期输出格式的示例
│   └── sample.md
└── templates/         # 供智能体填写的模板
    └── template.md

Vtrix 上的 Skill 原生支持此标准，同样适用于 Claude Code、Cursor、Windsurf 以及所有兼容该规范的工具。

写好 Skill

• 写好 description：description 是智能体在工具列表中看到的内容。模糊的 “docs” 毫无参考价值，“支付服务的 API 文档，包含接口列表、鉴权方式与错误码说明” 才能让智能体准确判断何时加载
• 保持 Skill 聚焦：一个 Skill 对应一个主题。不要把所有内容塞进一个庞大的 Skill，而是拆分为 code-review、security-checklist、api-reference 等独立单元，智能体只加载当前所需的部分
• 大体量内容用附属文件承载：将大型参考文档、API 规范和详细示例放在 references/ 或 examples/ 目录下，主指令保持简洁，需要细节时再引用这些文件
• 文件间使用相对路径链接：在指令中用 [查看参考](references/api-docs.md) 这样的相对路径，智能体可通过 skill_get 按需加载，本地智能体也能直接使用相同路径访问文件系统