Awesome QA Skills
面向 AI 编码 Agent 的双语 QA Agent Skills / AI 测试技能库,提供可独立安装的测试 Skill 和可复用 QA 工作流。覆盖需求分析、测试策略、测试用例、功能/API/UI、回归、性能、安全、发布,以及 AI、LLM 与 Agent 测试。
可用于 Codex、Cursor、Claude Code、Kiro、OpenCode、Trae 等工具;各工具的安装方式和验证范围见支持的 AI 工具。Skill 提供任务引导、测试设计和可复用流程;实际自动化运行取决于所选 Skill、Agent 和目标项目环境。


在线目录: 中文 Skill 目录
快速入口: 按任务查找 Skill · 完整技能目录 · 快速开始 · 社区推荐的外部 Skills · 安装说明 · 文档导航
项目包含什么
每种语言有 169 个 Skill,中英文合计 338 个 Skill 目录:
| 类别 |
数量 |
覆盖范围 |
| 测试工作流 |
14 / 语言 |
路由、需求到测试、PR 审查、变更回归、迭代与发布流程、质量视角 |
| 测试类型 |
150 / 语言 |
需求与策略、用例、功能/API/UI、回归、性能、安全、生产质量、AI/LLM/Agent 测试 |
| Skill Engineering |
5 / 语言 |
Skill 质量审查、评测、变更验证与文案审查 |
每个 Skill 都是可独立安装的目录,包含 SKILL.md、主提示词和工具元数据;部分 Skill 还提供示例、模板、脚本和评测用例。
按任务查找 Skill
表中的 Skill 名称是中英文共用的 canonical name。想看全部 Skill 和用途,打开完整技能目录。
不确定从哪里开始?使用测试技能路由。
快速开始
安装一个英文 Skill
npx skills add naodeng/awesome-qa-skills --skill functional-testing
安装一个中文 Skill
npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh --skill functional-testing
更多工具、语言和安装方式见安装说明。
使用方式
如果 AI 工具支持 Agent Skills 自动发现,可以直接用自然语言描述任务;也可以按 canonical name 安装或调用对应 Skill。
| 你可以这样说 |
推荐入口 |
| “帮我为用户登录功能生成测试用例” |
functional-testing |
| “检查这个 REST API 的错误、幂等和分页场景” |
api-testing |
| “发布前应该做哪些回归和 Go/No-Go 检查?” |
release-testing-workflow |
| “根据当前变更选择最小风险回归集” |
regression-test-selection |
| “评估这个 LLM 功能的行为和安全边界” |
llm-testing、prompt-injection-testing |
不确定从哪里开始时,使用路由 Skill discover-testing。支持 @skill 显式调用语法的工具可以这样写:
@skill discover-testing
我要做一次发布前回归,应该先选哪些检查?
Skill 分类
先按研发 / 测试阶段选择分类,再从对应入口安装或调用。已经知道名称时,直接打开完整技能索引。
| 分类 |
包含内容 |
入口 |
| 跨阶段工作流 |
路由、日常 / 迭代 / 发布、质量视角和多角色汇总 |
查看工作流 |
| Core QA Skills |
需求、策略、测试设计、执行、缺陷和报告 |
查看基础质量能力 |
| Engineering QA Skills |
质量左移、代码 / API / UI、回归、性能和持续改进 |
查看质量工程能力 |
| Production Quality Skills |
发布验证、生产验证、事故、Trace 和指标分析 |
查看生产质量能力 |
| AI Native QA Skills |
AI 功能、LLM、Prompt、Agent 和安全测试 |
查看 AI 原生质量能力 |
| Skill Engineering |
Skill 包质量审查、评测、变更验证、文案契约审查和过程性文案清理 |
查看 Skill Engineering |
能力分层
仓库用稳定目录负责安装,用能力层帮助选择和演进:
Core QA Skills → Engineering QA Skills → Production Quality Skills → AI Native QA Skills
ai-assisted-testing 是横向的 AI for QA,不等同于 AI Native QA 的 Testing for AI。六迭代路线与 Prompt Baseline 映射见演进路线图;长期 Existing / Enhance / Merge / Match / New 治理见 Skill 治理路线图。v1.4 的治理证据、版本规划和剩余边界见 Phase 0 收口。
完整技能目录
每种语言共 169 个 Skill:14 个工作流、150 个测试类型和 5 个 Skill Engineering;中英文合计 338 个目录。物理目录保持稳定,下面只提供逻辑导航。
跨阶段工作流
工作流负责串联研发测试阶段,不属于四个能力层中的第五层。
需求发现与分析
开发与迭代
发布与综合
四层能力体系与研发测试阶段
每个测试类型 Skill 只列一次;跨阶段协作由路由器和工作流补充。
Core QA Skills — 基础质量能力
需求发现与分析
方案设计与测试策略
测试设计与准备
测试执行与分析
发布、缺陷与报告
Engineering QA Skills — 质量工程能力
需求与质量左移
可靠性与安全
质量工程与效能
开发与持续集成
测试数据与自动化实现
测试执行与回归智能
性能工程与容量决策
复盘与持续改进
Production Quality Skills — 生产质量能力
发布与生产验证
生产运行与事故响应
AI Native QA Skills — AI 原生质量能力
AI 功能需求与风险
LLM 与 Prompt 评测设计
prompt-regression-testing 是 prompt-testing 内名为 prompt-regression 的增强模式,不创建别名目录。
Agent、工具与安全测试
Skill Engineering(横向治理)
Skill Engineering 服务所有能力层,不改变产品能力分类。英文 Skill 使用相同目录名;可从页面顶部切换语言。
支持的 AI 工具
这些工具有对应的一键安装器;也可以按安装说明使用 npx skills 或手动复制。
| 工具 |
默认安装目标 |
支持方式 |
| Codex |
~/.codex/skills/ |
一键脚本、npx skills、手动复制 |
| Cursor |
~/.cursor/skills/ |
一键脚本、npx skills、手动复制 |
| Claude Code |
~/.claude/skills/ |
一键脚本、npx skills、手动复制 |
| Kiro |
~/.kiro/skills/ |
一键脚本、手动复制 |
| OpenCode |
~/.opencode/skills/ |
一键脚本、手动复制 |
| Trae |
~/.trae/skills/ |
一键脚本、手动复制 |
Skill 目录遵循 Agent Skills 约定。其他兼容工具可以参考其 Skill 目录要求,直接复制对应语言目录或单个 Skill。
仓库结构
awesome-qa-skills/
├── skills/
│ ├── zh/ # 中文技能
│ │ ├── testing-workflows/ # 工作流
│ │ ├── testing-types/ # 测试类型
│ │ └── skill-engineering/ # 技能工程
│ └── en/ # 英文技能(结构同上)
├── scripts/ # 安装、校验、评测辅助脚本
├── installers/ # 按 skill / 工具生成的安装快捷脚本
├── resources/ # 公共参考素材池(非 skill 安装源)
├── legacy-prompts/ # 旧版根级提示词(正式入口见各 skill 内 prompts/)
├── AGENTS.md # Coding Agent 操作约定
├── docs/catalog/ # 全量索引与关系图
├── README.md / README_EN.md
└── LICENSE # PolyForm Noncommercial 1.0.0
单个 Skill 约定结构
skills/{zh|en}/{testing-types|testing-workflows|skill-engineering}/<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 校验。
需要对 codex exec --json 运行结果做本地确定性检测时,使用 Skill 本地评测规则、scripts/run_skill_trace_eval.py 和 scripts/grade_skill_trace.py;它会把缺失证据标记为 BLOCKED,不会替代模型辅助的语义评分。
用 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。
文档导航
社区推荐的外部 Skills
本栏收录社区提交的外部 Skill,供发现与参考。条目由源项目维护,不计入本仓库自身的 Skill 目录。许可证、版本和兼容性信息以链接的上游来源为准,并标注核验日期;列入本栏不代表本仓库已进行运行时评测。
贡献
欢迎提交 Issue / PR:新增 skill、补齐双语、改进 prompt 与 evals、完善安装与文档。
- 阅读 CONTRIBUTING.md 与 skills/SKILL_AUTHORING.md
- 中英文通常需同步更新(除非明确只要单语)
- 本地跑通
bash scripts/check_skills_quality.sh 后再提 PR
许可证
本仓库采用 PolyForm Noncommercial License 1.0.0。您可以自由使用、修改和分发本软件,但仅限非商业目的(如个人学习、研究、实验、慈善机构、教育机构、公共研究组织、政府机构等用途)。
评论