awesome-qa-skills Skill 技能

技能简介

awesome-qa-skills 是一款面向 AI 原生质量工程的开源技能系统，由开发者 naodeng 维护并在 GitHub 开源。该技能库将传统软件测试工作流拆解为可独立安装、可自由组合的 Agent Skill，面向 Codex、Cursor、Claude Code、Kiro、OpenCode、Trae 等主流 AI 编程工具提供可直接调用的测试能力。不同于单一测试工具，该项目以「技能组合」为核心思路——每个 Skill 均可独立运行，也可与其他 Skill 串联形成覆盖需求分析、用例设计、接口自动化、UI 自动化的完整质量工作流。

核心能力

需求与测试设计类（6个技能）

• requirements-analysis：支持从产品需求文档自动提取测试点，生成需求追踪矩阵
• test-strategy：根据风险等级和约束条件推荐测试策略，覆盖范围与优先级一目了然
• test-case-writing：将自然语言需求转化为结构化测试用例，支持边界值、等价类、场景法等多种设计方法
• risk-assessment：评估功能模块风险等级，辅助测试资源分配决策
• test-plan-generation：自动生成测试计划文档，包含范围、进度、资源、风险应对等标准章节
• acceptance-criteria-mapping：追踪需求验收标准与测试用例的映射关系，确保每个需求均有对应验证

接口自动化类（10个技能）

• api-test-executor：支持自然语言指令执行接口测试，解析「跑冒烟测试」等日常用语并自动完成环境配置与执行
• api-batch-runner：批量执行接口测试套件，支持参数化与数据驱动，输出统一格式报告
• api-contract-validation：基于 OpenAPI Schema 校验接口返回数据结构是否符合预期
• api-performance-baseline：为关键接口建立性能基准，支持定期回归对比，捕捉性能退化
• api-auth-handler：自动处理 OAuth2、API Key、Bearer Token 等多种认证方式的接口测试
• api-chaos-testing：向接口注入超时、错误码、异常响应等混沌场景，验证服务容错能力
• api-mock-server：本地启动 Mock 服务，模拟第三方依赖接口，支持独立开发和联调测试
• api-data-setup：自动准备测试数据，包括预置数据库状态、缓存初始化、第三方响应桩
• api-report-aggregator：聚合多个接口测试报告，生成统一的覆盖率与质量趋势看板
• api-regression-selector：基于代码变更范围智能选择需要回归的接口用例集，减少无效执行

UI自动化类（9个技能）

• ui-smoke-test：快速验证页面核心交互链路是否正常，如登录、提交、跳转等关键路径
• ui-visual-diff：捕获页面截图并与基准图对比，自动识别样式偏移与布局异常
• ui-cross-browser：多浏览器并行执行 UI 测试，覆盖 Chrome、Firefox、Safari、Edge 等主流环境
• ui-accessibility-check：检测页面无障碍访问达标情况，包括 ARIA 标签、键盘导航、屏幕阅读器兼容
• ui-form-validation：验证表单交互全流程，包括必填校验、格式校验、错误提示文案是否准确
• ui-loading-state：检测页面加载状态、骨架屏、loading 动画是否正确触发与消失
• ui-data-flow-trace：追踪用户在界面上的操作与后端数据变化的因果关系，辅助排查数据不一致问题
• ui-e2e-scenario：编写端到端用户故事测试，从进入页面到完成业务目标全流程自动化
• ui-performance-monitor：监测页面渲染性能指标，包括 FCP、LCP、CLS、TTI 等核心 Web Vitals

安装配置

前提条件

• 支持 Claude Code、Cursor、Codex、Trae 等主流 Agent 编程工具
• 本地需安装 Git 与 Node.js 环境（部分 Skill 执行依赖）
• 推荐使用 skills.sh CLI 或直接复制 skills/ 目录下的 markdown 文件到工具的 skills 目录

方式一：通过 skills.sh 一键安装（推荐）

# 安装 skills.sh CLI
npm install -g @skills/cli

# 查看所有可用技能
skills list naodeng/awesome-qa-skills

# 安装全套技能
skills add naodeng/awesome-qa-skills

# 安装指定分类技能
skills add naodeng/awesome-qa-skills/testing-types

方式二：手动复制安装

# 克隆仓库
git clone https://github.com/naodeng/awesome-qa-skills.git

# 将所需技能文件复制到 Agent 工具的 skills 目录
# 以 Claude Code 为例
cp -r skills/zh/* ~/.claude/skills/

# 重启 Agent 工具使技能生效

方式三：在线浏览技能目录

访问 https://inaodeng.com/qaskills/ 查看完整技能索引与每个 Skill 的详细说明文档。

使用步骤

第一步：确认测试目标

明确需要验证的功能模块或测试类型（需求分析、接口测试、UI 测试），从技能索引中选择对应的 Skill。

第二步：安装并激活技能

通过上述任一方式完成技能安装，在 Agent 工具中以自然语言描述测试需求，例如「帮我跑一下登录模块的冒烟测试」。

第三步：配置测试环境

根据 Skill 提示配置目标系统地址、认证凭证、测试数据源等参数。部分 Skill 支持通过环境变量或配置文件批量设置。

第四步：执行并查看报告

Agent 自动调用 Skill 执行测试，输出结构化报告。如接口测试返回通过率、响应时间、失败用例详情；UI 测试返回截图对比与错误堆栈。

第五步：组合技能形成工作流

多个 Skill 可串联使用，例如先用 requirements-analysis 分析需求，再用 test-case-writing 生成用例，然后 api-test-executor 执行接口验证，最后 api-report-aggregator 汇总报告，实现全流程自动化。

适用场景

• 团队测试左移：在需求评审阶段即接入 requirements-analysis 和 test-strategy，提前识别测试盲区
• 持续集成流水线：将 api-batch-runner 和 ui-e2e-scenario 接入 CI/CD，在每次代码提交后自动运行回归测试
• 第三方接口对接：使用 api-mock-server 独立开发，用 api-contract-validation 确保联调阶段接口一致性
• AI 编程工具提效：在 Cursor 或 Claude Code 中直接调用 Skill，让 AI 生成的代码自动附带测试验证能力

适用人群

• 质量保障工程师（QE）、测试开发工程师（SDET）
• 使用 AI 编程工具进行开发的全栈工程师
• DevOps 团队，需要将测试嵌入自动化交付流水线
• 技术负责人，构建团队级 AI 测试能力标准

工作原理

每个 Skill 本质上是一个结构化的 Markdown 指令文件，定义了特定测试任务的输入格式、处理逻辑、输出规范。Agent 工具读取 Skill 文件后，结合当前项目上下文和用户指令，调用代码执行环境完成测试操作。Skill 之间通过标准化的输入输出格式实现互联互通——例如 test-case-writing 的输出可直接作为 api-test-executor 的输入，实现测试用例到自动化脚本的无缝衔接。技能库采用版本化管理（当前 v1.4），通过 GitHub Issues 收集社区反馈并持续迭代。

官方链接

• 技能在线目录：https://inaodeng.com/qaskills/
• GitHub 仓库：https://github.com/naodeng/awesome-qa-skills
• 技能索引文档：https://github.com/naodeng/awesome-qa-skills/blob/main/docs/catalog/skills-index.md
• 安装指南：https://github.com/naodeng/awesome-qa-skills/blob/main/scripts/INSTALL_SKILLS.md