保姆级Skills搭建全流程,附带MD文档资料直接套用

最近 AI Agent 领域变化太快了。

从 Prompt Engineering，到 RAG，再到 MCP，工程化能力一路往上走。但测试同学每天还是在重复写用例、读接口文档、整理 Bug 报告、分析日志……

很多人用上了 Cursor、Claude 这类工具，第一反应是「AI 居然能帮我写测试用例」。用了一两周，问题就来了，同一个接口每次生成的结构都不一样，Bug 报告格式乱七八糟，关键场景还漏测。

其实不是 AI 不行，是它不知道你团队的测试规范。Agent Skills，就是把这个缺口补上的一种方法。

一、Skills 到底是什么？

一句话讲清楚，Skills 就是给 AI 准备的「插件包」——一个文件夹，装着操作指令、可执行脚本和参考素材。

AI 接到任务后，会先判断要不要加载某个 Skill，需要时才把对应内容读进来。这个机制叫按需加载（Progressive Disclosure），不会把上下文窗口一下子撑爆。

站在测试工程师视角：你把测试 SOP 写进一个文件，AI 就会按 SOP 工作。

二、标准目录结构

SKILL.md 是整个 Skill 的灵魂，包含使用场景、工作流程和输出格式三部分。建议主文件控制在 500 行以内，详细规范放到 references/ 目录按需加载。

三、为什么测试工程师特别适合用 Skills？

测试工作天然就是 流程 + 模板 + 规范 的组合。把这些套路写进 Skills，AI 就能按你的规矩干活。

场景 1，接口测试用例自动生成。 手动写一个接口 10～20 分钟，写好 Skill 后 AI 几秒钟输出覆盖正常/异常/边界/鉴权的完整用例表。

场景 2，Bug 报告自动整理。 用户只说「登录报错了」，把描述粘进 Bug Report Skill，AI 自动生成含复现步骤、环境信息的结构化报告。

场景 3，日志分析。 写一个 Log Analysis Skill，AI 自动提取错误信息、判断异常类型、给出排查建议。

四、从零搭建，五步搞定

第一步：创建目录

第二步：编写 SKILL.md

必须以 YAML 前置元数据开头，name 和 description 是必填项：

description 是关键，AI 靠它判断什么时候调用。正文写清楚分析步骤、覆盖范围和输出格式：

第三步：添加 references

第四步：配置触发词

description 里写清楚，「当用户需要生成接口测试用例、根据 Swagger 设计测试时使用」。

第五步：调用测试

五、写好 Skill 的关键经验

1. description 决定一切 — 80% 的触发准确率取决于它写得好不好

2. 给示例，不给空话 — 一个表格模板，输出基本都会按结构来

3. 一个 Skill 只做一件事 — 多个专注 Skill 比一个巨型 Skill 效果好

4. 增量迭代 — 先从 Markdown 基本说明开始，跑通后再加脚本

5. Skills 可以组合 — AI 会自动组合调用多个 Skill

写在最后

真正会被替代的，是重复、机械、没有流程沉淀的工作。Agent Skills 让测试工程师能够把经验沉淀下来、把流程自动化、把 AI 变成真正的生产力工具。

未来每个测试团队，很可能都会拥有自己的 QA Skills 库。

📦 资料自取

完整 Skills模板、目录结构示例、SKILL.md 样板文件及测试场景专用 Skill 合集，均已整理在配套资料包中。

👉 评论区回复「666」即可获取全套文档资料，直接套用即可上手。

以上，如果觉得不错，随手点个赞、在看、转发三连吧～