qa-skills

简体中文 | English

qa-skills

让 AI 像资深测试工程师一样工作。

面向 AI 编程 Agent 的测试工程 Skill 框架。
从需求澄清、风险决策，到可执行用例、自动化与测试报告。

把测试方法、流程与产出标准装进你的 Agent：12 个测试 skill + 一个共享知识库 core/。可以跑完整流水线，也可以只写用例、审查、测接口或治理 flaky 测试。先看五组真实产出对照，了解安装前后的区别。

快速开始 · 选择 skill · 工作原理 · 兼容性与边界 · 实测效果 · 文档导航

快速开始

1. 安装全部 skill

通过 skills.sh 从 GitHub 安装（需要 Node.js 提供 npx，无需登录 npm）：

npx skills add fishzjp/qa-skills --skill '*'

按安装器提示选择宿主与安装范围。保留 --skill '*'：core/ 是必需的共享依赖，不是独立触发的 skill。 单装某个 skill 而不带 core/ 会使相对路径引用断开；补救时重新执行上面的全量安装命令。

git clone https://github.com/fishzjp/qa-skills.git
cd qa-skills
./install.sh                 # 交互选择宿主目录

./install.sh --target ~/.agents/skills

./install.sh --target ~/.dsh/skills

2. 检查安装与装载

安装目标应包含下方技能清单中的目录及 core/，例如 qa/SKILL.md 与 core/executability.md。只有仓库 install.sh 会额外写入 qa-skills.VERSION，其他方式不能用该文件判断成功与否。

按宿主要求刷新技能或新开会话，试一句“请使用 test-strategy，为这个需求制定测试策略”。从宿主的装载记录确认 test-strategy/SKILL.md 及所需 core/ 文件已读取；没有装载记录时，可要求 Agent 列出实际读取的文件路径。仅目录存在不代表触发已成功。

3. 提供输入，开始测试

在被测项目中对 Agent 说：

帮我测试这个需求：优惠券到期后自动结束。
需求：<替换为你的 PRD 路径>
代码：当前仓库；回归对比基线：main
先完成需求分析和测试策略，列出需要我确认的问题。

需求可以是文字、PRD、接口文档或已有用例。提供代码可补充实现证据；只有文档时会保留待确认项。进入执行阶段前，还需要可访问的测试环境、测试账号与运行工具：Web E2E 使用 Playwright，API 测试使用 Python / pytest 等，压测按需使用 k6。安装 skill 不会同时安装这些工具或被测系统。

完整流程会在需求澄清、执行策略、Bug 定性与预算裁决处等待你确认。只需要一步时，直接使用下面对应的请求。

选择 skill

core/ 是以上 skill 共用的方法、模板与脚本，完整索引见 core/SKILL.md，无需单独调用。

工作原理

阶段产出保存为文件，后续阶段按文件衔接。 流水线中断后，在新会话中提供产物目录，让 qa 根据阶段完成判据续跑。

PRD / 代码 ──（文档不足时先探索）
   ↓ requirement-analysis
需求模型.md                         ⏸ 澄清
   ↓ test-strategy
测试策略.md + type_scope            ⏸ 预算（触及裁决条件时）
   ↓ test-case-writing → test-case-review
测试用例_markmap.md + schema.yaml   ⏸ 执行策略
   ↓ Playwright / API / 手动执行
执行记录 + 缺陷证据                  ⏸ Bug 定性
   ↓ bug-analysis / regression-testing（按需）
Bug 条目 / 回归清单 → 测试报告

• 可执行的用例：写清前置条件、操作入口、步骤、可判定结果与异步时限。标准见 executability.md，完整产物见用例示例。
• 有证据的范围决策：证据分级 E0–E4；风险评级附依据，十个测试类型逐一决定纳入、深度或排除，记录在可校验的 type_scope 中。
• 按需装载：SKILL.md 保留触发边界与工作流，方法和模板放在 core/、references/ 中。宿主支持子会话时按阶段隔离上下文；否则用顺序会话与文件衔接，具体遵循效果仍需在该宿主验证。
• 跨会话知识：阶段状态留在产物文件中；可复用的项目经验由 qa-memory 管理，避免与流水线状态混写。

兼容性与边界

产品以 Markdown 指令、相对路径引用与按需运行的辅助脚本分发。宿主需要支持 skill 发现、文件读取；实际执行还需要终端或浏览器工具。

安装实测的日期与具体命令见 RELEASING 安装矩阵。安装成功、触发正确、产出质量是三个不同的验证层次。

语言：README 与官网提供中英文；12 个 skill 中 11 个的 description 为双语，bug-analysis 暂保留中文以避免已观测到的路由回退；skill 指令正文仍为中文。

范围：聚焦系统级黑盒测试的决策与执行。不提供单元 / 集成测试、移动真机自动化、前端组件测试、专业渗透 / SAST / 依赖扫描或混沌工程工具链；这些领域可作为风险信号或专项移交内容，不能把移交视为已经执行。

实测效果

以下是历史实验结果，并非对当前工作区重新评测，也不代表每个模型、每个宿主都能获得同样提升。数字来自早期 12 任务的注入式 On/Off 对照及后续执行专项复验，具体见逐项口径。同一对照内模型与评测链路相同；裁判类指标采用与生成模型不同源的裁判。各轮样本量与任务范围不同，不能合并计算。

版本对应的证据请看里程碑 Release 增益矩阵快照，后续变更与勘误见 CHANGELOG；examples/ 展示单任务产出。评测 harness、任务池与原始数据在维护者本地维护，不随仓库分发。

文档导航

skills/       产品：各 skill 的 SKILL.md、references/、templates/、scripts/
  core/       共享知识库，文件索引见 core/SKILL.md
examples/     真实 On/Off 产出与判读指南
scripts/      架构与仓库校验器
tests/        产品脚本、守门脚本回归测试与安装器冒烟
.dsh/         历史 dsh 插件兼容代码与配置
assets/       README / 社交图片与落地页字体
install.sh    仓库安装器（拷贝或软链）
uninstall.sh  对应卸载器
index.html    官网落地页源文件
llms.txt      机器可读产品摘要

贡献与反馈

欢迎按贡献指南提交改进。使用问题与经验分享到 Discussions，可复现缺陷与具体需求提交 Issues。安全漏洞请按安全策略私密报告。

行为准则 · MIT 许可证