TRAE Skills 入门教程:给 AI 写一份工作手册
你有没有遇到过这种情况:每次让 AI 写代码,都得重复说一遍“用 TypeScript”“用 Vue3 组合式 API”“CSS 用 Tailwind”……说多了真的烦。
TRAE 的 Skills 功能就是来解决这个问题的。简单来说,它就是给 AI 写一份“工作手册”——你把规则写好,AI 以后就按你的规矩来。
这篇文章将从零开始教你上手 Skills,看完就能自己写一个。
一、Skills 到底是个啥
官方定义有点绕,我用人话说一下:
Skills = 给 AI 写的工作手册
你把“遇到什么任务、按什么步骤做、输出什么格式”写在一个文件里,AI 就会自动按照这个流程执行。就像给新员工写 SOP 一样。
举个例子:你可以写一个“写 React 组件”的 Skill,规定好:
创建 index.tsx 文件,用函数组件
创建 styles.module.css,用 CSS Modules
创建 tests/index.test.tsx,写基础测试
以后每次你说“帮我写一个 XX 组件”,AI 就会自动按这个三步走,不用你再啰嗦了。
二、一个 Skill 长什么样
每个 Skill 的核心就是一个 SKILL.md 文件。结构很简单,就三个部分:
第一部分:头部信息
name:技能名称
description:一句话描述这个技能干嘛的
version:版本号
第二部分:触发条件
什么情况下应该自动加载这个技能
第三部分:执行步骤
具体按什么步骤来做,每一步做什么
来看一个真实的例子。这是一个“创建 React 组件”的 Skill:
--- SKILL.md ---
name: create-react-component
description: "生成标准 React 函数组件,包含样式和测试"
version: "1.0.0"
# 执行步骤
1. 创建 index.tsx,定义函数组件,使用 TypeScript
2. 创建 styles.module.css,使用 CSS Modules
3. 创建 __tests__/index.test.tsx,添加基础测试用例就这么简单。你写得越详细,AI 执行得越精准。
三、三种创建方式,选你最顺手的
TRAE 给了你三种方式来创建 Skill,从简单到复杂:
方式一:让 AI 自己写(最省事)
直接在对话框里跟 TRAE 说你的需求,它会自动生成 SKILL.md 文件。
你可以说:“帮我创建一个 Skill,当用户要求写 Vue3 组件时自动启用。要求使用组合式 API、TypeScript、Pinia 状态管理。”
方式二:手动编写(最灵活)
自己创建一个文件夹,在里面写 SKILL.md。适合有明确流程的标准化工作。
文件夹结构:
my-skill/
└── SKILL.md方式三:从社区导入(最丰富)
GitHub 上有现成的 Skills 仓库,或者把链接发给 TRAE,它会自动安装。社区已经有人分享了很多好用的技能包。
四、5 个社区推荐的实用 Skills
不知道写什么?先试试这 5 个论坛里口碑最好的:
requirements-analyst — 需求拆分与分析。像产品经理一样帮你细化需求,输出结构化的需求文档。
fullstack-developer — 全栈开发增强。写后端代码的质量明显提升,bug 更少。论坛用户强烈推荐。
webapp-testing — 自动化测试。开发过程中自动写单元测试,不用你单独操心测试的事。
ui-ux-pro-max — 高品质 UI 设计。对界面美观度有高要求的时候用这个,生成的页面更好看。
skill-creator — 技能创建器。让 AI 帮你写新的 Skill。没错,用 Skill 来创建 Skill,套娃了属于是。
五、怎么调用 Skill
装好 Skill 之后,有三种方式调用:
自动调用(最常用)
AI 自己判断你的需求,在合适的时候自动加载对应技能。你什么都不用做。
手动指定
在对话中直接说“用 XX Skill 来做”,AI 就会切换到对应技能。
斜杠命令(新版 SOLO 独立端)
输入 / 就能快速选择技能。论坛上有人说“斜杠掉技能真的太香了”。
六、实战:写一个“代码审查”Skill
来,跟着我一起写一个实用的 Skill。假设你想让 AI 帮你做代码审查,按以下标准检查:
--- SKILL.md ---
name: code-reviewer
description: "对代码进行审查,检查代码质量、安全性和性能问题"
version: "1.0.0"
# 审查维度
1. 代码质量:命名规范、函数长度、注释完整性
2. 安全性:SQL 注入、XSS、敏感信息泄露
3. 性能:不必要的循环、内存泄漏、N+1 查询
4. 可维护性:重复代码、耦合度、测试覆盖率
# 输出格式
按严重程度分级:[严重] [建议] [优化]
每个问题给出:位置、问题描述、修复建议把这个文件保存好,以后每次你说“帮我审查一下这段代码”,AI 就会按这四个维度自动检查,输出格式也统一。
七、几个让 Skill 更好用的技巧
1. description 要写清楚触发场景
别写“代码审查工具”,写“当用户要求审查代码、review PR、检查代码质量时启用”。越具体,AI 匹配越准确。
2. 步骤要具体,别写大话
别写“优化代码质量”,写“检查函数是否超过 50 行,超过则建议拆分”。AI 需要明确的指令。
3. 加上“不要做什么”
比如代码审查 Skill 里可以写“不要修改代码,只输出审查报告”。这比只说“做什么”更有效。
4. 善用全局技能和项目技能
全局技能在所有项目生效(比如编码规范),项目技能只在当前项目生效(比如这个项目用 Vue,那个用 React)。
5. 从简单开始,逐步迭代
先写一个最简单的版本用起来,用着用着发现需要补充的,再逐步完善。别一上来就想写完美的 Skill。
写在最后
Skills 是 TRAE 跟其他 AI 编程工具拉开差距的核心功能之一。Cursor 和 Windsurf 都没有这个能力。
它的本质就是把你的经验沉淀成可复用的资产。你踩过的坑、总结出的最佳实践,都可以写成 Skill,让 AI 永远记住。
建议从今天开始,先写一个最简单的 Skill 试试。你会发现,AI 按你的规矩干活的感觉,真的有点东西。
本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!