🛠️ Skills 完全指南:从入门到实战
Skills是赋予 AI Agent 专业能力的"技能包"。通过 Skills,你可以将通用的 AI 模型转化为特定领域的专家(如文档处理、数据分析、行政助手等)。
一、什么是 Skills? 🤔
Skills(技能) 是 Agent 的扩展能力模块。
如果把 AI 大模型比作一个"博学的大脑",那么 Skills 就是让大脑拥有具体动手能力的"工具包"和"操作手册"。
定义:Skills 是一组精心设计的指令、脚本和配置,用于指导 AI 如何完成特定任务。作用:专业化:让 AI 从"什么都懂一点"变成"某个领域的专家"。标准化:确保 AI 在执行任务时遵循统一的流程和标准。扩展性:可以无限扩展 AI 的能力边界(如操作数据库、生成 PPT、查询内部系统)。
核心价值:Text > Brain(文本记录优于大脑记忆)。通过文件化的技能定义,实现能力的持久化和复用。 💾
二、Skills 如何使用? 🚀
使用 Skills 通常非常简单,用户无需了解底层代码,只需通过**自然语言**触发。
1. 触发方式 ⚡
自然语言指令:直接描述需求。- 例 :"帮我总结一下这个会议纪要。"(自动触发
meeting-summarizer技能) - 例 :"查一下我的工位在哪里。"(自动触发
workstation技能)
- 例 :"帮我总结一下这个会议纪要。"(自动触发
关键词命中:当对话中包含特定关键词(如"Word"、"PPT"、"语雀"、"天气")时,系统会自动路由到对应的 Skill。显式调用:部分系统支持/skill_name命令显式调用。
2. 使用流程 🔄
用户发起请求(语音或文字)。系统识别意图,匹配最合适的 Skill。Skill 执行:读取配置、调用工具、处理数据。返回结果:以结构化报告、文件或消息形式反馈给用户。
三、Skills 的内部结构介绍 📂
一个标准的 Skill 通常是一个独立的文件夹,包含核心配置文件和可选的辅助资源。
📂 标准目录结构
my-skill-name/
├── SKILL.md # 🌟 核心文件:技能的"大脑"
├── /scripts # ⚙️ 可选:执行脚本 (Python/Shell)
├── /references # 📚 可选:参考文档/模板
└── /assets # 🖼️ 可选:静态资源 (图片/图标)
1. SKILL.md (必读核心) 📘
这是 Skill 的**灵魂文件**,定义了技能的名称、描述、触发条件、执行逻辑和约束。
内容包含:Description:技能是做什么的?Triggers:什么情况下触发?(关键词、意图)Workflow:执行步骤(第一步做什么,第二步做什么)。Constraints:什么不能做(安全红线)。
作用:Agent 在执行任务前会先阅读此文件,遵循其中的指令。
2. /scripts (可选) ⚙️
存放具体的执行代码。
- 当 Skill 需要执行复杂计算、调用外部 API 或处理文件时,会调用这里的脚本。
- 例 :
generate_ppt.py,query_db.sh。
3. 其他可选文件 📁
/references:存放 Prompt 模板、文档样例、API 文档链接等,供 AI 参考。/assets:技能图标、示例图片等。
四、Skills 的调用逻辑 🧠
Skills 的调度是一个**智能路由**过程:
意图识别 (Intent Recognition)🔍- 系统分析用户输入,提取关键词和语义意图。
- 例 :用户说"转成 Word",意图被识别为
docx。
技能匹配 (Skill Matching)🎯- 系统遍历所有已加载的
SKILL.md描述。 - 计算用户意图与技能描述的**
匹配度**。 优先级:特定技能 > 通用技能。
- 系统遍历所有已加载的
上下文加载 (Context Loading)📥- 加载对应的
SKILL.md内容到 AI 的上下文窗口。 - AI "阅读"技能说明书,理解当前任务的约束和流程。
- 加载对应的
任务执行 (Execution)⚡- AI 根据技能定义,调用工具(如
write,exec,browser)完成任务。 - 如有脚本,自动执行
/scripts中的代码。
- AI 根据技能定义,调用工具(如
结果反馈 (Feedback)📤- 输出结果,并根据技能定义进行格式化(如生成 Markdown 表格、发送通知)。
**调用流程**如下

五、测试工程师能利用 Skills 做什么? 🧪
对于测试工程师(QA/SDET),Skills 是**提升效能的利器**:
| 场景 | 传统方式 | 利用 Skills |
|---|---|---|
测试数据构造 🎲 |
写 SQL 或脚本手动造数 | 指令:"帮我生成 10 条包含边界值的测试用户数据。" → 调用 data-generator 技能**自动写入数据库**。 |
日志分析 📜 |
登录服务器 grep 日志 | 指令:"分析昨晚支付失败的日志,找出主要错误码。" → 调用 log-analyzer 技能**自动聚合报错**。 |
报告生成 📊 |
手动复制粘贴写测试报告 | 指令:"根据这次的 Jira 执行记录,生成一份测试总结周报。" → 调用 report-writer 技能**输出 Markdown 文档**。 |
环境检查 🏥 |
逐项手动 ping 接口 | 指令:"检查一下预发环境的所有核心服务状态。" → 调用 health-check 技能**批量探测**并返回健康度。 |
用例管理 📝 |
手动同步用例到平台 | 指令:"把这篇语雀文档里的用例同步到 Dima 上。" → 调用 case-sync 技能**自动解析**并创建工单。 |
核心价值:释放双手,让 AI 处理重复劳动,让人专注于**测试设计和 质量分析**。 🎯
🚀 结语
Skills 是连接"想法"与"落地"的桥梁。 🌉
对于测试团队而言,熟练掌握和开发 Skills,意味着从"手工执行者"向"工具设计者"的转变。