在调试项目时,我注意到一个常见问题:许多团队都在使用 Claude 进行代码审查,但如果用的是非 Claude 的 IDE(比如 TRAE),是否就无法利用 Agent Skills 了?答案显然是否定的。
本文将以 TRAE 为例,演示如何在不依赖 Claude 原生环境的前提下,让模型识别并调用 Agent Skills。同时借助一个实际案例——导入自动代码审查(code review)技能——来展示完整的执行流程。
坦白说,TRAE 虽然提供了可视化窗口用于创建和导入 Skills,但若需导入外部 Skills,体验并不理想:用户必须先下载压缩包,再手动拖拽,步骤繁琐且效率低下。而本文介绍的方法仅需 Node.js 环境,全程通过命令行完成,更通用,也更高效。
Agent Skills 简介
什么是 Agent Skills
可以把它理解为一份为 AI 助手量身定制的操作指南——明确指示在何种场景下调用哪个技能以及如何执行。其本质是一套模块化的工具包,包含格式化的提示词、元数据,并可附带可执行脚本、图片等附加资源。
简而言之,这是一种工程化手段,能将专业经验和固定流程打包成可复用的资产,随取随用。
Agent Skills 的作用
- 自动触发:Agent 能够自主判断当前任务是否需要调用特定 Skill,无需人工干预。
- 提高复用性:若某个标准化流程(SOP)需反复使用,可将其从系统提示词中独立出来,形成可复用的 Skill。例如代码审查(code-review)每次写完代码都需要执行,非常适合做成 Skills。
- 节省 Token,优化上下文利用:无需每次都向 Agent 灌输大量预置提示词,从而释放上下文窗口,使其能处理更复杂的任务。
- 跨平台统一:不同团队有各自的代码规范。以往需通过配置 Rules 约定,但每个 IDE 配置方式不同。使用 Skills 管理,一套配置可跨平台通用,还能通过 Git 托管,十分便捷。
Agent Skills 的工作原理
Agent Skills 的核心机制是“渐进式披露”,即分三层按需加载:
- 层级 1:技能发现 —— AI 先读取所有 Skills 的元数据(名称和描述),判断当前任务是否相关。这些元数据始终内置在系统提示中。
- 层级 2:加载核心指令 —— 若任务相关,AI 将自动读取 SKILL.md 的正文,获取详细操作指南。
- 层级 3:加载资源文件 —— 仅在真正需要时,才会读取额外脚本、示例文件,或通过工具执行脚本。
简而言之,按需加载,Token 就是这么省下来的。
Agent Skills 使用教程
先确认环境:Node.js v22.14.0 及以上版本。
步骤 1:下载 Skills
在命令行中运行以下代码,以下载一个 code-review 专家的 Skills:
npx skills add https://github.com/sanyuan0704/code-review-expert
运行后,系统会先让你选择安装到哪个 AI Agent,列表中涵盖常见 IDE 和 Agent。下次运行时它会记住你的选择,无需重新指定。接着选择安装到当前项目还是全局,具体视使用场景而定。然后询问你是只下载一套 Skills(方便后续更新),还是每个 Agent 各自维护一套——通常建议选前者,更省心。确认信息无误后即开始安装,完成后会看到成功提示。
安装完成后,项目目录结构大致如下:
.agents:Skills 的实际存储位置。.trae:TRAE 用来读取 Skills 的目录。skills-lock.json:核心配置文件,记录了你已安装的 Skills 信息。
如果选择了多个 IDE(例如同时添加 Antigra vity),则可能多出一个文件夹(如 .agent),因为不同 IDE 读取 Skills 的方式不同,Skills 库需做相应兼容处理。
步骤 2:验证 Skills 是否可用
在聊天窗口输入相关指令后,你会发现大模型已能自动选择并调用合适的 Skills。执行完成后,会给出清晰的反馈结果。
其他 Skills 库的常用命令
移除 Skills:
npx skills remove [技能名称]
更新所有 Skills 到最新版:
npx skills update
查看已安装的 Skills:
npx skills ls
安装某个组织下的特定 Skills
例如下载 Anthropics 官方的 skill-creator(技能创建工具):
npx skills add anthropics/skills --skill skill-creator
后记
code-review-expert 的执行流程
code-review 专家的执行流程已封装在仓库中,地址为:GitHub - sanyuan0704/code-review-expert: Expert code review skill: SOLID, security, performance, error handling, boundary conditions。有需要可直接获取体验。
Skills 商店
如果你想查找市面上热门的 Skills,可访问以下两个平台:
- skillsmp.com/zh
- skills.sh/
参考
- Overview - Agent Skills
- 技能 - 文档 - TRAE
- 使用 skills 扩展 Claude - Claude Code Docs
- Agent Skills | 菜鸟教程
