Awesome QA Skills

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

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

---

为什么用这个仓库

每个 skill 目录复制出去后应自洽：含 SKILL.md、主提示词、工具元数据，以及可选的示例、模板、脚本与评测用例。

支持的 AI 工具

也可手动 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
我要做一次发布前回归，该选哪些技能？

---

技能目录

单语合计 38 个技能（4 工作流 + 34 测试类型）；中英双语共 76 个目录。完整索引见 skills-index.md。

工作流技能

测试类型技能

核心执行

过程与产出物

工具专项

增强版（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                      # GPL-3.0

单个 Skill 约定结构

skills/{zh|en}/{testing-types|testing-workflows}//
├── 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。

文档导航

贡献

欢迎提交 Issue / PR：新增 skill、补齐双语、改进 prompt 与 evals、完善安装与文档。

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

许可证

本仓库采用 GNU GPL v3。可自由使用、修改与分发；衍生作品需遵循相同许可证条款。