非Claude工具(TRAE/Cursor)使用Agent Skills指南

在调试项目时，我注意到一个常见问题：许多团队都在使用 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 | 菜鸟教程