# QA 测试与修复 (qa)

> 测试网站、API 或 CLI，按严重程度修复发现的 bug，每个修复都配回归测试并单独提交。

- 分类: [测试与调试](https://www.myskills.tools/zh/categories/testing-debugging/)
- 来源: 社区 · Garry Tan
- 代码仓库: https://github.com/garrytan/gstack/tree/main/qa (commit ed10791 · v2.0.0)
- SKILL.md: https://github.com/garrytan/gstack/blob/main/qa/SKILL.md
- 安装命令: `npx skills add garrytan/gstack --skill qa`
- 许可证: MIT
- 兼容工具: Claude Code, Codex, Cursor, Copilot
- 权限: read-repo ✓, write-files ✓, shell ✓, network ✓
- 状态: 扫描通过
- 规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。
- ⚠ 会为每个验证过的修复执行 git commit；工作区不干净时会请你选择先提交或暂存改动。

## 核心规则

修复前先写出能复现缺陷的回归测试，只提交经过验证的修复。

## 执行阶段

1. **准备** — 解析目标、修复级别和模式；工作区不干净时让用户选择提交、暂存或中止，并创建报告目录。
2. **基线 QA** — 对目标运行探索式检查，浏览器和功能检查结果分开记录，修复前先报告基线发现。
3. **分级** — 按严重程度排序并套用所选级别，低于级别或无法从源码修复的问题标记为延后。
4. **修复循环** — 复现问题、先写回归测试、做最小修复、重新测试并逐个提交；两次回滚即停止，最多 50 个修复。
5. **终检与报告** — 重新检查受影响的功能，计算健康分，写出 QA 报告并更新 TODOS.md。

## 权限说明（据 SKILL.md 整理）

| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 需要 | 修改出问题的源文件、新增回归测试并写入 QA 报告；不改 CI 配置，也不削弱现有测试。 |
| 命令执行 | 需要 | 运行 git、测试命令、浏览器与功能探测以及 gstack 脚本。 |
| 网络外发 | 需要 | 可访问被测目标 URL，并使用 WebSearch。 |

## SKILL.md 头部信息（YAML）

```yaml
---
name: qa
preamble-tier: 4
version: 2.0.0
description: Test the site, API or CLI and fix the bugs it finds. (gstack)
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - AskUserQuestion
  - WebSearch
triggers:
  - qa test this
  - find bugs on site
  - test the site
---
```

首页: https://www.myskills.tools/zh/ · URL: https://www.myskills.tools/zh/skills/qa/