从零玩转 Skill:Trae 和 Claude Code 的使用全攻略

你是不是也这样:明明给 AI 写了一大堆规则,它转头就忘;每次做代码审查、生成文档、处理表格,都要从头教一遍。其实,AI 编程早就进化出了 Skill(技能) 这个神器——把固定流程打包成“技能包”,让 AI 一键调用,再也不用反复“调教”。

今天我就手把手教你,在 Trae IDEClaude Code 里怎么真正用上 Skill,让 AI 真正变成你的得力干将。


一、Skill 是什么?

  • Skill 就是一个包含 SKILL.md 说明文件 + 脚本 + 模板 的文件夹。

  • 你把某个任务(比如“检查 API 规范”、“生成 Excel 报表”)的操作步骤和规则写进去。

  • AI 会在需要时自动加载并按照你的剧本执行。

你可以把它想象成 给 AI 安装的一个 APP,随叫随用


二、在 Trae IDE 中使用 Skill

Trae 对 Skill 的支持非常友好,支持全局 Skill(所有项目可用)和项目 Skill(仅当前项目)。

2.1 创建 Skill 的两种方法

方法一:图形化界面(新手友好)
  1. 打开 Trae,点击右上角 ⚙️ 设置 → 左侧菜单选择 「规则和技能」

  2. 找到 技能(Skill) 栏,点击 「创建」 按钮。

  3. 填写信息:

    • 类型:全局 / 项目

    • 名称:小写字母+连字符,如 api-checker

    • 描述关键! 必须写清楚技能做什么、什么时候用。 示例:用于检查 REST API 是否符合团队规范,当需要评审或编写 API 时使用。

    • 指令:分步骤写清楚 AI 要执行的动作。

  4. 点击保存,Skill 即刻生效。

方法二:手动创建文件夹(更灵活)
# 全局 Skill 目录
~/.traecli/skills/my-skill/
​
# 或项目 Skill 目录(在项目根目录下)
.traecli/skills/my-skill/

在里面创建 SKILL.md 文件:

---
name: api-style-guide
description: 检查 API 是否符合团队设计规范。当用户提到“审查 API”、“检查接口设计”时使用。
---
​
# API 审查步骤
1. 读取用户指定的 API 定义文件(OpenAPI / 代码注解)。
2. 检查以下规范:
   - 是否使用资源命名复数形式(如 /users,不是 /user)
   - 是否包含版本号(如 /v1/)
   - 错误响应是否遵循统一格式(code, message, data)
3. 输出不符合项清单和修改建议。

2.2 如何使用 Skill

自动触发(推荐) 当你在 Trae 的 AI 助手(Chat / Builder)中提问,且内容与 Skill 的 description 匹配时,Trae 会自动加载该 Skill 并执行。

比如你说“帮我 review 一下这个 API 设计”,上面那个 api-style-guide 就会自动激活。

手动开关 在 Trae v3.3.24 及以上版本,你可以在技能管理界面手动开启/关闭某个 Skill。

2.3 典型使用场景示例

场景一:数据质量体检 有一个社区分享的“数据对象体检” Skill,用法如下:

  1. 编写 SKILL.md,内容包含:先只读检查数据完整性、一致性;发现问题后生成修复脚本(不直接修改);最后回归验证。

  2. 在项目中放入该 Skill 文件夹。

  3. 当你对 AI 说“检查一下这个 data.json 的数据质量”,Skill 自动执行三步骤,输出体检报告。

场景二:多智能体分层协作 Trae 支持一个项目配置多个 Skill,每个 Skill 负责不同层级(工具层、数据层、逻辑层等)。你只需要说“按照我们的架构生成用户模块代码”,AI 会自动调度各层 Skill 协同工作。


三、在 Claude Code 中使用 Skill

Claude Code 的 Skill 系统更偏向“插件化”,支持手动调用/技能名)和自动匹配。

3.1 安装现成 Skill

Claude Code 官方提供了 17 个开箱即用的 Skills,比如处理 PDF、Excel、Word、PPT。

# 第一步:添加官方插件市场
/plugin marketplace add anthropics/skills
​
# 第二步:安装你需要的 Skill(以 PDF 为例)
/plugin install document-skills@anthropic-agent-skills

安装完成后,运行 /skills 查看已安装的 Skill 列表。

使用:直接对 Claude 说“帮我提取这个 PDF 里的表格”,它会自动调用 pdf Skill;或者手动输入 /pdf 分析 report.pdf

3.2 手动安装第三方 Skill

从 GitHub 或其他渠道下载一个 Skill 文件夹(包含 SKILL.md),放到对应目录:

# 个人 Skill(推荐,仅自己可用)
~/.claude/skills/my-skill/
​
# 项目 Skill(团队共享,提交到 Git)
项目根目录/.claude/skills/my-skill/

无需重启,立即生效。

3.3 创建自己的 Skill

Step 1:创建目录和文件

mkdir -p ~/.claude/skills/code-reviewer
cd ~/.claude/skills/code-reviewer
touch SKILL.md

Step 2:编写 SKILL.md

---
name: code-reviewer
description: 对代码进行安全、性能、规范三方面审查。当用户说“review 代码”、“检查这段代码”时自动匹配。
---
​
# 代码审查工作流
​
## 输入
需要审查的代码片段或文件路径。
​
## 步骤
1. **安全检查**:检查 SQL 注入、XSS、硬编码密钥、不安全的反序列化。
2. **性能检查**:发现 O(n^2) 以上循环、未优化的正则、内存泄漏风险。
3. **规范检查**:命名风格、注释完整性、错误处理。
​
## 输出格式
- 列出问题按严重程度(高/中/低)排序。
- 每条问题附上所在行号和修改建议。
​
## 示例
用户输入:

def get_user(id): return db.execute("SELECT * FROM users WHERE id = " + id)

输出:
🔴 严重:第2行存在 SQL 注入风险,应使用参数化查询。
...

Step 3:测试 Skill

  • 在 Claude Code 中运行 /skills,确认 code-reviewer 出现在列表中。

  • 输入“帮我 review 下面这段代码”,粘贴你的代码,看是否自动触发。

3.4 常用 Skill 调用技巧

需求 调用方式 说明
处理 PDF /pdf extract 文件.pdf 或 “把这个 PDF 转成图片” 自动匹配
分析 Excel /xlsx 对 sales.xlsx 做数据透视 或 “计算这个表格的总和”
生成单元测试 直接说“为 utils.js 生成单元测试” 若安装了 unit-test Skill
写 commit 信息 git diff | /commit-message 手动管道传递

3.5 高级用法:Skill + Hook 联动

你可以在 .claude/hooks/ 中配置一个 Hook,当执行 git commit 时自动触发某个 Skill 做代码检查,不通过则拒绝提交。 示例 pre-commit hook:

#!/bin/bash
claude run --skill code-reviewer --files $(git diff --cached --name-only)
if [ $? -ne 0 ]; then
    echo "代码审查未通过,请修复后重新提交"
    exit 1
fi

四、Trae vs Claude Code:使用上的小差异

操作 Trae Claude Code
创建 Skill 图形界面 + 手动文件夹 只能手动文件夹
触发方式 自动语义匹配 自动匹配 + /技能名 手动
查看已有 Skill 设置 → 规则和技能 /skills 命令
共享 Skill Skill Registry(中心化) 插件市场 / Git 仓库
调试 Skill 需要反复对话测试 可用 --debug 模式运行

个人建议

  • 如果你喜欢可视化操作,用 Trae

  • 如果你习惯命令行、管道、脚本化,用 Claude Code

  • 两者都支持项目级 Skill,团队协作时记得把 .skills/ 目录提交到 Git。


五、避坑指南 & 最佳实践

5.1 描述要精准,别太宽泛

❌ 不好的描述:用于处理各种事情 ✅ 好的描述:用于从 PDF 发票中提取公司名称、金额和日期。当用户提到“发票”、“PDF 提取”时使用。

5.2 每个 Skill 只做一件事

你不需要做一个“超级全能 Skill”。把“前端代码审查”和“后端 API 审查”分成两个 Skill,AI 更容易精准匹配。

5.3 示例写具体

SKILL.md 里放输入示例输出示例,AI 执行效果会好一倍。

5.4 版本控制你的 Skills

把项目级的 .skills/ 目录纳入 Git,团队成员拉下来就能用。 对于 Trae 全局 Skill,可以考虑用 dotfiles 管理 ~/.traecli/skills/

5.5 安全提醒

  • 不要从不可信的来源直接运行 Skill,尤其包含脚本的。

  • 如果 Skill 里有 shell 脚本,用前先 cat 看一眼。


六、写在最后

Skill 不是未来概念,它就是今天就能让你告别重复“调教” AI 的武器。

现在你可以这样做:

  1. 打开 Trae 或 Claude Code。

  2. 花 5 分钟创建一个你最常用的任务 Skill(比如“写 commit 信息”、“检查代码风格”)。

  3. 下一次再做同样的事,只需一句话,AI 自动按你的标准执行。

你会发现,AI 从“有时靠谱的实习生”变成了“永远稳定的资深助手”。

快去试试吧!如果遇到有趣的使用场景,欢迎留言分享,我们一起把 Skill 玩得更溜。


相关资源

  • Trae 官方 Skill 文档:https://docs.trae.ai/skills

  • Claude Code Skills 开放标准:https://agentskills.io

  • 社区 Skill 仓库(GitHub):awesome-claude-skills

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐