<div align="right"><strong>🇨🇳中文</strong> | <strong><a href="./README_EN.md">🇬🇧English</a></strong></div>

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、完善安装与文档。

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

许可证

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