从零玩转 Skill:Trae 和 Claude Code 的使用全攻略
从零玩转 Skill:Trae 和 Claude Code 的使用全攻略
从零玩转 Skill:Trae 和 Claude Code 的使用全攻略
你是不是也这样:明明给 AI 写了一大堆规则,它转头就忘;每次做代码审查、生成文档、处理表格,都要从头教一遍。其实,AI 编程早就进化出了 Skill(技能) 这个神器——把固定流程打包成“技能包”,让 AI 一键调用,再也不用反复“调教”。
今天我就手把手教你,在 Trae IDE 和 Claude Code 里怎么真正用上 Skill,让 AI 真正变成你的得力干将。
一、Skill 是什么?
-
Skill 就是一个包含
SKILL.md说明文件 + 脚本 + 模板 的文件夹。 -
你把某个任务(比如“检查 API 规范”、“生成 Excel 报表”)的操作步骤和规则写进去。
-
AI 会在需要时自动加载并按照你的剧本执行。
你可以把它想象成 给 AI 安装的一个 APP,随叫随用
二、在 Trae IDE 中使用 Skill
Trae 对 Skill 的支持非常友好,支持全局 Skill(所有项目可用)和项目 Skill(仅当前项目)。
2.1 创建 Skill 的两种方法
方法一:图形化界面(新手友好)
-
打开 Trae,点击右上角 ⚙️ 设置 → 左侧菜单选择 「规则和技能」。
-
找到 技能(Skill) 栏,点击 「创建」 按钮。
-
填写信息:
-
类型:全局 / 项目
-
名称:小写字母+连字符,如
api-checker -
描述:关键! 必须写清楚技能做什么、什么时候用。 示例:
用于检查 REST API 是否符合团队规范,当需要评审或编写 API 时使用。 -
指令:分步骤写清楚 AI 要执行的动作。
-
-
点击保存,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,用法如下:
-
编写
SKILL.md,内容包含:先只读检查数据完整性、一致性;发现问题后生成修复脚本(不直接修改);最后回归验证。 -
在项目中放入该 Skill 文件夹。
-
当你对 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 的武器。
现在你可以这样做:
-
打开 Trae 或 Claude Code。
-
花 5 分钟创建一个你最常用的任务 Skill(比如“写 commit 信息”、“检查代码风格”)。
-
下一次再做同样的事,只需一句话,AI 自动按你的标准执行。
你会发现,AI 从“有时靠谱的实习生”变成了“永远稳定的资深助手”。
快去试试吧!如果遇到有趣的使用场景,欢迎留言分享,我们一起把 Skill 玩得更溜。
相关资源
-
Trae 官方 Skill 文档:
https://docs.trae.ai/skills -
Claude Code Skills 开放标准:
https://agentskills.io -
社区 Skill 仓库(GitHub):
awesome-claude-skills
更多推荐




所有评论(0)