Awesome QA Skills
按语言分区的 AI 测试辅助技能库(Agent Skills)。面向 Codex、Cursor、Claude Code、Kiro、OpenCode、Trae 等工具,提供可独立安装、可组合调用的测试工作流与测试类型技能。
在线站点: https://inaodeng.com/qaskills/
为什么用这个仓库
| 能力 | 说明 |
|---|---|
| 双语对齐 | skills/zh 与 skills/en 同名目录、同结构,团队可按语言选用 |
| 覆盖完整测试链 | 从需求分析、策略、用例、执行到缺陷与报告 |
| 工作流 + 类型技能 | 日常 / 迭代 / 发布、角色质量视角与多角色汇总工作流,配合 36 类专项技能按需组合 |
| 开箱即装 | 支持一键安装与单 skill 安装脚本 |
| 可评测可演进 | 全量 skill 附带 evals/,可用 skill-up 校验与实跑 |
每个 skill 目录复制出去后应自洽:含 SKILL.md、主提示词、工具元数据,以及可选的示例、模板、脚本与评测用例。
支持的 AI 工具
| 工具 | 典型安装目标 |
|---|---|
| Codex | ~/.codex/skills/ |
| Cursor | ~/.cursor/skills/ |
| Claude Code | Claude skills 目录(见安装文档) |
| Kiro / OpenCode / Trae | 见 scripts/INSTALL_SKILLS.md |
也可手动 cp -r 单个 skill 目录到对应工具的 skills 路径。
5 分钟上手
1. 克隆仓库
git clone https://github.com/naodeng/awesome-qa-skills.git
cd awesome-qa-skills
2. 安装技能(任选其一)
# 一键:全部工具 × 中英文
bash ./install-skills-mac.sh --tool all --lang all
# 仅 Codex + 中文
bash ./install-skills-mac.sh --tool codex --lang zh
# 单个 skill(示例:功能测试 → Codex)
bash installers/zh/functional-testing/mac/codex.sh
Windows:
powershell -ExecutionPolicy Bypass -File .\install-skills-windows.ps1 -Tool all -Lang all
手动复制:
cp -r skills/zh/testing-types/functional-testing ~/.cursor/skills/
完整参数与工具路径说明:scripts/INSTALL_SKILLS.md
3. 在工具中调用
@skill functional-testing
帮我为用户登录功能生成测试用例
不确定用哪个 skill 时,先用路由技能:
@skill discover-testing
我要做一次发布前回归,该选哪些技能?
技能目录
单语合计 46 个技能(10 工作流 + 36 测试类型);中英双语共 92 个目录。完整索引见 skills-index.md。
工作流技能
| 名称 | 目录 | 适用场景 |
|---|---|---|
| 日常测试工作流程 | daily-testing-workflow |
日常冒烟、缺陷跟进、当日计划 |
| 迭代测试工作流程 | sprint-testing-workflow |
Sprint 规划、增量验收、迭代风险 |
| 发布测试工作流程 | release-testing-workflow |
发布门禁、回归范围、上线检查 |
| 测试技能路由 | discover-testing |
根据目标推荐应调用的 skill |
| 产品质量视角 | product-quality-perspective |
从用户价值、业务规则、范围与验收角度分析质量 |
| QA 质量视角 | qa-quality-perspective |
评估可测试性、风险驱动覆盖、缺陷风险与证据边界 |
| UX 质量视角 | ux-quality-perspective |
识别信息架构、交互状态、一致性、响应式与无障碍风险 |
| 技术质量视角 | technical-quality-perspective |
基于架构、代码、安全、性能与可观测性证据分析技术质量 |
| 项目交付视角 | project-delivery-perspective |
记录带来源的排期、产能、依赖和行动,不改变质量事实 |
| 多角色质量汇总 | multi-role-quality-synthesis |
合并同阶段角色报告并保留来源、分歧和质量边界 |
测试类型技能
核心执行
| 名称 | 目录 |
|---|---|
| 功能测试 | functional-testing |
| API 测试 | api-testing |
| 自动化测试 | automation-testing |
| 手动 / 探索性测试 | manual-testing |
| 性能测试 | performance-testing |
| 安全测试 | security-testing |
| 移动端测试 | mobile-testing |
| 可访问性测试 | accessibility-testing |
过程与产出物
| 名称 | 目录 |
|---|---|
| 需求分析 | requirements-analysis |
| 测试策略 | test-strategy |
| 测试策略评审 | test-strategy-review |
| 测试用例编写 | test-case-writing |
| 测试用例评审 | test-case-reviewer |
| 代码审查 | code-review |
| 缺陷上报 | bug-reporting |
| 测试报告 | test-reporting |
| 测试报告评审 | test-report-review |
| AI 辅助测试 | ai-assisted-testing |
工具专项
| 名称 | 目录 |
|---|---|
| API 测试(Bruno) | api-test-bruno |
| API 测试(Postman) | api-test-postman |
| API 测试(Pytest) | api-test-pytest |
| API 测试(Rest Assured) | api-test-restassure |
| API 测试(Supertest) | api-test-supertest |
| UI 自动化测试(Selenium) | ui-test-selenium |
| UI 自动化测试(Playwright) | ui-test-playwright |
| UI 自动化测试(TestCafe) | ui-test-testcafe |
| UI 自动化测试(Cypress) | ui-test-cypress |
| UI 自动化测试(Puppeteer) | ui-test-puppeteer |
| UI 自动化测试(WebdriverIO) | ui-test-webdriverio |
| 性能测试(k6) | performance-test-k6 |
| 性能测试(Gatling) | performance-test-gatling |
| 性能测试(JMeter) | performance-test-jmeter |
增强版(Plus)
| 名称 | 目录 |
|---|---|
| 需求分析增强版 | requirements-analysis-plus |
| 测试策略增强版 | test-strategy-plus |
| 测试用例编写增强版 | testcase-writer-plus |
| 测试用例评审增强版 | test-case-reviewer-plus |
英文版本路径将
skills/zh替换为skills/en,目录名与技能名保持一致。语言分区索引:skills/zh/README.md · skills/en/README.md
仓库结构
awesome-qa-skills/
├── skills/
│ ├── zh/ # 中文技能
│ │ ├── testing-workflows/ # 工作流
│ │ └── testing-types/ # 测试类型
│ └── en/ # 英文技能(结构同上)
├── scripts/ # 安装、校验、评测辅助脚本
├── installers/ # 按 skill / 工具生成的安装快捷脚本
├── resources/ # 公共参考素材池(非 skill 安装源)
├── legacy-prompts/ # 旧版根级提示词(正式入口见各 skill 内 prompts/)
├── AGENTS.md # Coding Agent 操作约定
├── skills-index.md # 全量技能索引
├── README.md / README_EN.md
└── LICENSE # PolyForm Noncommercial 1.0.0
单个 Skill 约定结构
skills/{zh|en}/{testing-types|testing-workflows}/<skill-name>/
├── SKILL.md # 入口 + YAML frontmatter(必需)
├── prompts/ # 主提示词(必需)
├── agents/openai.yaml # OpenAI / Codex 元数据(必需)
├── evals/ # skill-up 评测用例(本仓库全量具备)
├── output-formats.md # 可选:多格式输出说明
├── quick-start.md # 可选:最短上手路径
├── references/ · examples/ · scripts/
└── ...
详细规范:skills/DIRECTORY_GUIDE.md · skills/SKILL_AUTHORING.md
设计原则
- 语言分区,名称对齐:中英文 skill 目录名一致,不再使用
-en后缀;英文 prompt 文件名不带_EN。 - 独立可安装:禁止 skill A 硬链 skill B 内部文件;跨 skill 只做文案推荐。
- 渐进披露:
SKILL.md保持精简;细节放在prompts/、references/、examples/。 - 可执行产出:默认 Markdown;需要 Excel/CSV/JSON/Word 时按
output-formats.md切换。 - 安全默认:示例与文档不硬编码真实 token、密码、私钥;使用环境变量或占位符。
质量与评测
提交前建议在仓库根目录运行:
bash scripts/check_skills_quality.sh
该门禁覆盖目录整理、agents 元数据、独立安装约束、完整性校验,以及 skill-up evals YAML 校验。
用 skill-up 校验 / 实跑(可选):
curl -fsSL https://raw.githubusercontent.com/alibaba/skill-up/main/install.sh | bash
bash scripts/validate_skill_evals.sh
bash scripts/run_skill_eval.sh skills/zh/testing-types/functional-testing/evals/eval.yaml
推荐试点:functional-testing、api-testing、api-test-bruno、bug-reporting、performance-test-k6。说明见 skills/SKILL_AUTHORING.md。
文档导航
| 文档 | 用途 |
|---|---|
| AGENTS.md | Coding Agent 约定与质量检查 |
| skills-index.md | 全量技能索引 |
| skills/DIRECTORY_GUIDE.md | 目录与命名规范 |
| skills/SKILL_AUTHORING.md | 编写与 skill-up 评测约定 |
| scripts/INSTALL_SKILLS.md | 安装参数与工具路径 |
| FAQ.md | 常见问题 |
| CONTRIBUTING.md | 贡献流程 |
| skills-graph.md | 技能关系图(参考) |
贡献
欢迎提交 Issue / PR:新增 skill、补齐双语、改进 prompt 与 evals、完善安装与文档。
- 阅读 CONTRIBUTING.md 与 skills/SKILL_AUTHORING.md
- 中英文通常需同步更新(除非明确只要单语)
- 本地跑通
bash scripts/check_skills_quality.sh后再提 PR
许可证
本仓库采用 PolyForm Noncommercial License 1.0.0。您可以自由使用、修改和分发本软件,但仅限非商业目的(如个人学习、研究、实验、慈善机构、教育机构、公共研究组织、政府机构等用途)。
No comments yet
Be the first to share your take.