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

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

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

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

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

一、Skills 到底是什么？

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

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

| 类型

说明

官方内置技能

文档生成、表格处理等，系统自动调用

| |

自定义技能

最核心，自己写 Markdown 定义工作流

| |

合作伙伴技能

配合 MCP 做跨平台深度集成

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

二、标准目录结构

<section><img data-aistatus="1" data-imgfileid="100003648" data-s="300,640" data-type="png" type="block" data-ratio="0.2602739726027397" data-w="730" data-src="https://mmbiz.qpic.cn/sz_mmbiz_png/mmGIs3bCLQd4fYUQtpibia0GARVIf0K61icVMEAficBZicibNFpia6bDNwN1BiaWwcHIILLhicVhQ6pvm1ZAIoxBL7jG4zDUfwKpPKazdH6Gf7SjZsa0/640?wx_fmt=png&amp;from=appmsg&amp;watermark=1#imgIndex=3" data-original-style="height: auto !important;" data-index="6" src="/ai002/images/pool/20260816/ef697fbd9824e33e.png" _width="677px" alt="图片" data-report-img-idx="3" data-fail="0"></section>

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

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

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

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

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

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

四、从零搭建，五步搞定

第一步：创建目录

<section><img data-aistatus="1" data-imgfileid="100003649" data-s="300,640" data-type="png" type="block" data-ratio="0.1712707182320442" data-w="724" data-src="https://mmbiz.qpic.cn/sz_mmbiz_png/mmGIs3bCLQfBLcFJ8Uflz3NvETIURDiaZ7ibAxAQoZ5SQnibhmFLicfhahibYsJibH2HVyZFEFDYvAu0bZp0sALOjibKlPV0WWgic0GcCQAYDQiasmRs/640?wx_fmt=png&amp;from=appmsg&amp;watermark=1#imgIndex=6" data-original-style="height: auto !important;" data-index="9" src="/ai002/images/pool/20260816/12975314741b71d7.png" _width="677px" alt="图片" data-report-img-idx="5" data-fail="0"></section>

第二步：编写 SKILL.md

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

![图片](/ai002/images/pool/20260816/c0aad49139ceae72.webp)

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

<section><img data-aistatus="1" data-imgfileid="100003651" data-s="300,640" data-type="png" type="block" data-ratio="0.33748271092669435" data-w="723" data-src="https://mmbiz.qpic.cn/sz_mmbiz_png/mmGIs3bCLQc7vo6d456c8Asfl6TC7j8v3gUU82lXBwU4Vrdcyvy2Tk81YqEbJjOf9DsqIwqImlXiaz8gkSTJSRafAUibG5pa8OZqdJl27U1EY/640?wx_fmt=png&amp;from=appmsg&amp;watermark=1#imgIndex=9" data-original-style="height: auto !important;" data-index="12" src="/ai002/images/pool/20260816/b2c6ccc594223179.png" _width="677px" alt="图片" data-report-img-idx="9" data-fail="0"></section>

第三步：添加 references

<section><img data-aistatus="1" data-imgfileid="100003652" data-s="300,640" data-type="png" type="block" data-ratio="0.2620689655172414" data-w="725" data-src="https://mmbiz.qpic.cn/sz_mmbiz_png/mmGIs3bCLQflxYjO76RvgXz0rxyPEbaiaBPrbfHbmpMibficaNsrRk14KWD8GeiaZMmtpt61zGzQWpJemMLGIIe0haYa4x7n27Xo4L3ut4TSJGo/640?wx_fmt=png&amp;from=appmsg&amp;watermark=1#imgIndex=10" data-original-style="height: auto !important;" data-index="13" src="/ai002/images/pool/20260816/41b559c7b55ab7b1.png" _width="677px" alt="图片" data-report-img-idx="10" data-fail="0"></section>

第四步：配置触发词

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

第五步：调用测试

<section><img data-aistatus="1" data-imgfileid="100003653" data-s="300,640" data-type="png" type="block" data-ratio="0.16527777777777777" data-w="720" data-src="https://mmbiz.qpic.cn/mmbiz_png/mmGIs3bCLQcHnILxsHYkwp1hOpGoLINXxzkXHwK4uycwhN2u6YibBEpIGpNNblNko0IA34wnx2gT9YfD92HkutS3w5XHSaAgWBibTloRDxNibQ/640?wx_fmt=png&amp;from=appmsg&amp;watermark=1#imgIndex=11" data-original-style="height: auto !important;" data-index="14" src="/ai002/images/pool/20260816/b93ea5229d5d4687.png" _width="677px" alt="图片" data-report-img-idx="11" data-fail="0"></section>

五、写好 Skill 的关键经验

description 决定一切 — 80% 的触发准确率取决于它写得好不好
给示例，不给空话 — 一个表格模板，输出基本都会按结构来
一个 Skill 只做一件事 — 多个专注 Skill 比一个巨型 Skill 效果好
增量迭代 — 先从 Markdown 基本说明开始，跑通后再加脚本
Skills 可以组合 — AI 会自动组合调用多个 Skill

写在最后

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

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

📦 资料自取

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

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

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

文章目录