CommunityEscrita e Ediçãogithub.com

fishzjp/qa-skills

让 AI 像资深测试工程师一样工作:全生命周期 QA Agent Skills 框架——方法论 + 10 Skills + 可复现 Benchmark(Claude Code 等 Agent 可用)

O que é qa-skills?

qa-skills is a Claude Code agent skill that 让 AI 像资深测试工程师一样工作:全生命周期 QA Agent Skills 框架——方法论 + 10 Skills + 可复现 Benchmark(Claude Code 等 Agent 可用).

Funciona comClaude Code~Codex CLI~Cursor
npx skills add fishzjp/qa-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, affaan-m/seo, affaan-m/brand-voice · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

QA 编排入口(qa)

把"帮我测试这个需求"翻译成一条可断点续跑的流水线。本 skill 是薄编排:不含任何测试方法与框架知识(全部在阶段 skill 与 core/),不替用户做裁决。

When to Use

  • "帮我测试这个需求 / 功能"、"把这个功能完整过一遍"、"从需求到报告走一遍完整测试"
  • 之前的流水线中断了,需要从落盘产物续跑

When NOT to Use

  • 只要单阶段产出 → 对应阶段 skill:需求建模 requirement-analysis、测试策略 test-strategy、写用例 test-case-writing、审查已有用例 test-case-review、E2E 执行 automated-e2e-testing、API 执行 api-testing、探索会话 exploratory-testing、Bug 根因 bug-analysis、回归范围 regression-testing
  • 编写/修改某个阶段 skill 自身的方法论 → 不经过本 skill

编排会话模型(阶段间上下文隔离)

  • 每个阶段运行在独立上下文中(宿主支持子会话/子代理时):只加载当前阶段 skill 的 SKILL.md + 按需 references + 上一阶段的落盘产物文件;任一时刻活跃指令 ≤ 1–2 个 skill(当前阶段 + 本编排)
  • 主会话只持有流水线状态:阶段清单、各产物文件路径、检查点状态——不加载任何阶段 skill 的领域知识
  • 降级路径:宿主不支持子会话、或用户在单会话内手动走流水线时,退化为顺序会话 + 落盘文件衔接——正确性不受影响(状态全在文件里),损失的只是上下文卫生
  • 反模式:单会话内顺序累加加载全部 SKILL.md(9 个 × 数百行指令同时在场)
  • 注入式形态的例外(2026-08-23 R4):预注入部署(评测或宿主一次性注入全部指令)下本节隔离机制不存在——此时靠阶段顺序防串扰:任一时刻只执行当前阶段的指令,其余在场文件视为未加载;"文件即流水线状态"的原则两形态通用(双形态声明见 ../core/evidence.md 第 6 节)

流水线与落盘产物(文件即流水线状态)

#阶段skill落盘产物人工检查点
0(旁路,可选)探索先行exploratory-testing{项目}/探索笔记_{主题}.md
1需求理解requirement-analysis{项目}/需求模型.md(含澄清记录)⏸ 澄清检查点:模糊/矛盾项等用户裁决
2测试策略test-strategy{项目}/测试策略.md(Risk Map + 两域 scope 含 type_scope)+ 专项移交_{轴}_{日期}.yaml(有 handoff/blocked/外部执行器轴时)⏸ 预算裁决:full 预算裁剪触及 Critical 轴时呈现排序提案等用户裁决
3用例编写test-case-writing{项目}/测试用例_markmap.md + 测试用例.schema.yaml
4用例审查test-case-review修订后用例文件 + 审查记录(重新抽取 Schema)
5执行automated-e2e-testing / api-testing / 手动自动路径:执行代码或脚本(playwright/ 或 API 测试脚本)+ 执行分报告(至少 §2 执行统计 + §3 Bug 清单条目,字段按 ../core/report-template.md);手动路径 手动执行记录_{日期}.md⏸ 执行策略裁决:确认 automation_plan 提案(手动/e2e/api);手动路径执行后 ⏸ 结果回收(TC × 结果)
6Bug 分析bug-analysis(有已确认 Bug 时)中间产物 {项目}/Bug条目_{日期}.md(条目结构与根因分析等五个扩展字段按 report-template §3)——此阶段禁止新建或改写最终测试报告⏸ Bug 定性检查点:预期 vs 缺陷
7回归验证regression-testing(有代码变更/Bug 修复时){项目}/回归清单_{日期}.md
8收尾报告本 skill(按 ../core/report-template.md{项目}/测试报告_{日期}.md

旁路触发条件:文档缺失 / 系统陌生时,阶段 0 在阶段 1 之前先行,探索产出(系统理解 + 风险清单)作为需求建模输入。

手动执行路径无 skill 与自动产物——执行后按 ⏸ 结果回收检查点向用户索取结果,落盘 手动执行记录_{日期}.md(TC 编号 × 结果〔通过/失败/阻塞〕,失败附 Bug 编号或现象):作为阶段 8 报告 §2 执行统计与 §3 Bug 清单的数据来源,防"未执行"列成为永久状态。

阶段 6 的 Bug条目_{日期}.md中转中间产物:最终报告在阶段 8 才生成,此期间 Bug 条目无处追加——先落中转文件,阶段 8 拼装进报告 §3 后以报告为准,该文件归档留痕,不形成双数据源。阶段 2 生成的 专项移交_{轴}_{日期}.yaml 同样进入主会话的状态跟踪:后续任一阶段产出或用户反馈使移交轴状态变化时同步更新 yaml 内 execution_status,防移交包生成即失联。

工作流

1. 启动:意图识别与路由

  • 用户意图是端到端流水线 → 继续本 skill
  • 用户意图是单阶段产出 → 移交对应阶段 skill,本 skill 退出
  • 开工先收输入(用户提供或指路,产物对应位置留 TODO 指明"找谁拿什么"):需求材料、代码仓库、测试环境与账号

2. 断点检查(续跑)

检查 {项目}/ 下已有哪些落盘产物,从最后一个完整阶段之后继续,不重做已完成阶段。产物缺失/损坏则从该阶段重跑。

3. 按流水线顺序调度阶段 skill

  • 每个阶段:在独立上下文中调用对应 skill(或降级为顺序调用),输入 = 上一阶段的落盘产物文件路径(不是会话记忆)
  • 检查点暂停:遇到 ⏸ 环节,向用户呈现该阶段 skill 汇总的问题/提案,等待用户答复后再进入下一阶段;用户在澄清环节的明确答复具有最终裁决力(见 ../core/evidence.md 裁决规则),后续阶段不得推翻
  • 阶段产出落盘失败(文件未生成)→ 该阶段重跑,不进入下一阶段

4. 收尾:生成测试报告

全部阶段完成后(或用户要求提前收尾),按 ../core/report-template.md(此时加载)汇总生成 {项目}/测试报告_{日期}.md:范围、执行统计(自动运行结果与手动执行记录合并)、Bug 清单(拼装阶段 6 的 Bug条目_{日期}.md 并逐条同步状态——有回归结果的按结果更新为已验证关闭/已修复待验证,未回归的保持新建)、风险残留、回归摘要、类型域专项结果按 report-template §7 逐轴归一化回收(handoff / 外部执行 / blocked / exclude)、未闭环事项(含移交 yaml 各轴当前状态与去向)、各阶段产物路径索引。

5. 交付

向用户报告:最终报告路径 + 各阶段产物清单 + 未闭环事项(TODO 归属)。

硬规则

  1. 不做裁决:澄清、执行策略、Bug 定性、预算裁决一律呈现问题与建议后等用户,不代替用户决定
  2. 不含领域知识:测试方法、框架知识全部在阶段 skill 与 core/;本 skill 失败的唯一合理原因是编排错误,不是测试判断错误
  3. 状态全在文件:任何会话中断后,凭 {项目}/ 落盘产物即可续跑
  4. 阶段产物消费走文件:跨阶段传递的是产物路径,不是会话内转述

Common Mistakes

错误后果正确做法
把所有阶段 skill 的 SKILL.md 都加载进同一会话指令冲突、上下文爆炸阶段间上下文隔离,主会话只持状态
单阶段意图也启动流水线过度执行、浪费意图识别后移交对应阶段 skill
检查点自答(替用户裁决)裁决失效,后续阶段基于错误假设⏸ 环节必须等用户答复
凭会话记忆续跑(不读落盘文件)中断后状态丢失/不一致断点检查只认文件
编排层塞入测试方法论破坏薄编排、难以维护方法论全部下沉阶段 skill 与 core/
阶段 6 提前新建/改写最终测试报告与阶段 8 收尾同名双写、双数据源Bug 条目先落 Bug条目_{日期}.md 中转文件,收尾统一拼装

Habilidades Relacionadas

steipete/notion

Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.

community

affaan-m/seo

Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy. Use when the user wants better search visibility, SEO remediation, schema markup, sitemap/robots work, or keyword mapping.

community

affaan-m/brand-voice

Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and social workflows. Use when the user wants voice consistency without generic AI writing tropes.

community

affaan-m/crosspost

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

community

affaan-m/x-api

X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.

community

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

community