一、Skill 是什么？
Skill 文件就是一份给 AI 的说明书，告诉它：
"遇到这类任务，你必须按我规定的方式来做。"
没有 Skill，AI 每次生成的代码风格、覆盖的用例、用的选择器都可能不一样。 有了 Skill，AI 就像一个被你调教好的测试同事，每次输出都符合团队规范。
二、Skill 文件放在哪里？
文件夹是封面，.SKILL.md 是说明书：
项目文件夹
└── xx.SKILL.md ← 这就是说明书
文件名随便起，后缀必须是 .SKILL.md。
说明书可以有多本，一个功能模块一个文件，互不干扰。
三、Skill 文件的结构
一个 Skill 文件分两部分：
（头部信息：描述这个 Skill 是干什么的）
（正文：告诉 AI 具体怎么做）
四、头部信息逐行解释
name: Login Testing
Skill 的名字，随便起，让人一眼看懂就行。
description: Step-by-step login test cases covering happy path, error handling, and edge cases
一句话描述这个 Skill 能干什么。AI 会用这个来判断要不要激活它，写清楚一点。
version: 1.0.0
版本号，第一次写就填 1.0.0。
author: your-team
作者，填你的名字或团队名。
testingTypes: [functional, e2e]
测试类型。常见值：functional（功能测试）、e2e（端到端）、visual（视觉）、api（接口）。
frameworks: [playwright, selenium, cypress]
支持的框架，填你们团队在用的就行。
languages: [typescript, javascript, python]
支持的语言，AI 会根据你的项目自动选择。
domains: [web]
适用场景，web 表示网页测试，还有 mobile、api 等。
agents: [claude-code, cursor, github-copilot, windsurf, cline]
支持哪些 AI 工具。这是个意图声明，告诉别人这份说明书兼容哪些工具，不代表放进去就自动生效。
五、正文怎么写？
正文就是用自然语言告诉 AI 必须怎么做。写得越具体，AI 越听话。
5.1 先告诉 AI 它的角色
You are a senior QA engineer. When the user asks you to write, review,
or improve login test cases, follow these instructions precisely.
翻译：你是资深 QA 工程师，用户让你写登录测试时，严格按下面的规则来。
给 AI 一个明确的角色，输出会更专业、更聚焦。
5.2 告诉 AI 必须做什么
## What You Must Always Do
1. Cover the happy path first.
2. Cover error cases — wrong password, wrong username, empty fields.
3. Use descriptive test names.
4. Each test must be independent.
翻译：先写正常流程，再写异常流程，测试名要能看懂在测什么，每个用例必须独立。
5.3 给 AI 一个固定的用例结构
Every login test must follow this structure:
GIVEN [the user is on the login page]
WHEN [the user performs an action]
THEN [the expected result happens]
经典的 Given-When-Then 格式，测试同学都熟悉。告诉 AI 用这个格式，生成的用例逻辑更清晰。
5.4 列出必须覆盖的用例
## Required Test Cases
Always generate at least these 6 test cases:
1. Valid credentials → redirect to dashboard
2. Wrong password → show error message
3. Wrong username → show error message
4. Empty username → show inline validation
5. Empty password → show inline validation
6. Both fields empty → show both validation messages
明确告诉 AI 最少要写哪几条，不然它可能只写 2-3 条就交差了。
5.5 给一个完整的代码示例
这是 Skill 文件里最有价值的部分。给 AI 看一个标准答案，它之后生成的代码就会对齐这个风格。
## Example Output (Playwright + TypeScript)
When the user asks for Playwright tests, generate code in this exact format:
```typescript
import { test, expect } from '@playwright/test';
const STANDARD_USER = 'standard_user';
const VALID_PASS = 'secret_sauce';
test.describe('Login Page', () => {
test.beforeEach(async ({ page }) => {
await page.goto('https://www.saucedemo.com');
});
test('TC01 - standard_user 正常登录应跳转到商品列表页', async ({ page }) => {
await page.getByPlaceholder('Username').fill(STANDARD_USER);
await page.getByPlaceholder('Password').fill(VALID_PASS);
await page.getByRole('button', { name: 'Login' }).click();
await expect(page).toHaveURL(/\/inventory\.html/);
});
});
```
注意：测试名带编号 TC01 方便追踪，beforeEach 统一处理打开登录页，不在每个用例里重复写。
5.6 告诉 AI 绝对不能做什么
## What You Must Never Do
- Never use waitForTimeout or sleep.
- Never write a test that depends on another test.
- Never ignore the error message text.
禁止清单很重要。AI 有时候会走捷径，比如用 sleep(3000) 等待页面加载，明确禁止它就不会这么干了。
六、怎么用这个 Skill？
本质就一句话：把说明书的路径告诉 AI，它就能按规范干活。
用 @ 手动指定文件路径：
@.claude/skills/login-testing.SKILL.md 帮我写 SauceDemo 登录页的测试用例，用 Playwright + TypeScript
AI 读到文件内容，照着里面的规范干活，效果完全一样。
还可以继续追问：
| 你说 | AI 会做 |
|---|---|
| "再加上 problem_user 的测试" | 补充图片异常的断言 |
| "帮我加上 Page Object Model" | 把代码重构成 POM 结构 |
| "改成 Python + pytest 版本" | 换语言重新生成 |
| "这个用例的断言对吗？" | 帮你 review 代码 |
实际效果 这里我用的是Claude Code演示
接下来是漫长等待，安装依赖的过程（中间遇到问题，都会由大模型帮你解决）,最后如下：
直接复用
七、在不同 AI 工具里怎么让 Skill 自动生效？
.claude/skills/ 是 Kiro 专属路径，其他工具有自己约定的规则文件位置。
把 Skill 正文内容复制到对应文件里，工具启动时就会自动加载。
| 工具 | 把正文内容放到这个文件 |
|---|---|
| Kiro | .claude/skills/*.SKILL.md |
| Claude Code | CLAUDE.md |
| Cursor | .cursorrules 或 .cursor/rules/*.mdc |
| Windsurf | .windsurfrules |
| Cline | .clinerules 或 .clinerules/*.md |
Skill 正文内容是通用的，换工具只需要换个文件名，内容复制过去就行。
八、写 Skill 的几个原则
| 原则 | 说人话 |
|---|---|
| 角色明确 | 告诉 AI 它是谁 |
| 规则具体 | 越细越好，别指望 AI 猜你的意思 |
| 给示例 | 一个好例子胜过一百句描述 |
| 写禁止清单 | 把你不想看到的东西明确列出来 |
| 用英文写正文 | 大模型对英文指令理解更准确、更稳定 |
九、常见问题
Q：Skill 文件不生效怎么办？
A：检查后缀是否完整，必须是 .SKILL.md，不是 .md。
Q：可以有多个 Skill 文件吗？
A：可以，每个功能模块一个，比如 login-testing.SKILL.md、api-testing.SKILL.md。
Q：Skill 里的代码示例要和项目完全一致吗？ A：不需要，AI 会根据示例风格来生成，细节它会自己适配。
Q：正文必须用英文吗？ A：强烈建议。大模型对英文指令的理解比中文更稳定，出错概率更低。
