Awesome QA Skills

按语言分区的 AI 测试辅助技能库(Agent Skills)。面向 Codex、Cursor、Claude Code、Kiro、OpenCode、Trae 等工具,提供可独立安装、可组合调用的测试工作流与测试类型技能。

License: PolyForm Noncommercial 1.0.0 Skills Workflows Testing types skills.sh

在线站点: https://inaodeng.com/qaskills/


为什么用这个仓库

能力 说明
双语对齐 skills/zhskills/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-testingapi-testingapi-test-brunobug-reportingperformance-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、完善安装与文档。

  1. 阅读 CONTRIBUTING.mdskills/SKILL_AUTHORING.md
  2. 中英文通常需同步更新(除非明确只要单语)
  3. 本地跑通 bash scripts/check_skills_quality.sh 后再提 PR

许可证

本仓库采用 PolyForm Noncommercial License 1.0.0。您可以自由使用、修改和分发本软件,但仅限非商业目的(如个人学习、研究、实验、慈善机构、教育机构、公共研究组织、政府机构等用途)。