README

🇨🇳中文 | 🇬🇧English

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 和目标项目环境。

Awesome QA Skills 社交媒体预览图

License: PolyForm Noncommercial 1.0.0 Skills Workflows Testing types Skill engineering skills.sh

在线目录: 中文 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 开始
分析需求、制定测试策略 需求分析 · 验收标准评审 · 测试策略 · 一页纸测试策略
编写或评审测试用例 测试用例编写 · 测试用例评审
测试 API 或浏览器 UI API 测试 · Playwright UI 自动化测试
根据代码变更选择回归范围 回归测试选择
设计性能测试或使用 k6 性能测试 · k6 性能测试
检查安全风险或 Prompt 注入 安全测试 · Prompt 注入测试
评估 LLM 或 AI Agent LLM 测试 · AI Agent 测试
以 TDD 开发并记录测试证据 TDD 质量工作流
做发布前检查或上线后验证 发布测试工作流 · 生产验证

不确定从哪里开始?使用测试技能路由。

快速开始

安装一个英文 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 个目录。物理目录保持稳定,下面只提供逻辑导航。

跨阶段工作流

工作流负责串联研发测试阶段,不属于四个能力层中的第五层。

需求发现与分析
名称 目录 主要用途
测试技能路由 discover-testing 在执行前根据需求、阶段和风险选择合适的测试 Skill。
需求到测试工作流 requirement-to-test 串联需求质量、可测试性、策略、用例设计与需求追踪。
产品质量视角 product-quality-perspective 从产品视角在需求、策略、评审、用例和报告阶段识别用户价值、业务规则、验收与风险。
QA 质量视角 qa-quality-perspective 在质量各阶段基于证据评估可测试性、风险驱动覆盖、缺陷风险与质量结论边界。
UX 质量视角 ux-quality-perspective 以 UX 视角在质量阶段识别信息架构、交互状态、一致性、响应式与无障碍风险。
技术质量视角 technical-quality-perspective 在指定交付阶段基于证据输出技术质量发现。
开发与迭代
名称 目录 主要用途
日常测试工作流程 daily-testing-workflow 按日常节奏完成计划、执行、缺陷跟踪和日终收口。
迭代测试工作流程 sprint-testing-workflow 覆盖迭代计划、测试执行、评审和复盘的质量工作流。
TDD 质量工作流 tdd-quality-workflow 按 Red、Green、Refactor 记录可核对的测试与质量证据。
项目交付视角 project-delivery-perspective 在支持的策略与报告评审阶段记录带来源的交付约束和行动,不改变质量事实。
PR 质量审查工作流 pr-quality-review 汇总代码审查、测试影响、测试有效性和证据门禁。
变更到回归工作流 change-to-regression 从代码变更推导必测/可延后回归范围和未覆盖风险。
发布与综合
名称 目录 主要用途
发布测试工作流程 release-testing-workflow 从发布前计划到 Go/No-Go 决策和发布后监控的质量工作流。
多角色质量汇总 multi-role-quality-synthesis 将同一阶段的多角色报告合并为保留来源、分歧和质量边界的可追溯汇总

四层能力体系与研发测试阶段

每个测试类型 Skill 只列一次;跨阶段协作由路由器和工作流补充。

Core QA Skills — 基础质量能力
需求发现与分析
名称 目录 主要用途
需求分析 requirements-analysis 在测试设计前识别需求测试点、边界、依赖和风险。
需求分析加强版 requirements-analysis-plus 解析多种需求文档并输出结构化的需求分析。
方案设计与测试策略
名称 目录 主要用途
测试策略 test-strategy 定义测试范围、方法、资源、风险和质量门禁。
一页纸测试策略 one-page-test-strategy 一页呈现七阶段生命周期、功能/性能/安全、测试象限、精益分层与迭代反馈。
测试策略加强版 test-strategy-plus 基于需求、分析、技术和计划文档形成结构化测试策略。
测试策略评审 test-strategy-review 基于证据评审测试策略,区分阻塞项与条件项并给出 Human 待决的 AI 建议
测试设计与准备
名称 目录 主要用途
测试用例编写 test-case-writing 编写覆盖正常、异常和边界场景的高质量测试用例。
测试用例编写加强版 testcase-writer-plus 根据需求与分析产物生成高质量测试用例。
测试用例评审 test-case-reviewer 评审测试用例的完整性、清晰度、可维护性和遗漏场景。
测试用例评审加强版 test-case-reviewer-plus 从需求、策略和用例文档中形成结构化评审发现。
决策表测试 decision-table-testing 将条件、规则、动作和结果整理为可审计的规则组合。
状态迁移测试 state-transition-testing 从状态、事件、迁移和非法路径设计可追溯测试。
边界值测试 boundary-value-testing 基于边界模型选择最小且高风险的边界测试集。
等价类划分 equivalence-partitioning 将输入空间划分为可解释、可覆盖的等价类。
成对组合测试 pairwise-testing 用成对交互覆盖控制多参数组合爆炸。
组合测试 combinatorial-testing 根据交互强度和风险选择组合覆盖策略。
基于模型测试 model-based-testing 从状态、流程或行为模型派生可追溯测试。
基于属性测试 property-based-testing 用不变量、生成策略和收缩规则验证属性。
变形测试 metamorphic-testing 在缺少可靠预言机时用输入变换和关系断言验证结果。
测试执行与分析
名称 目录 主要用途
功能测试 functional-testing 为业务流程、界面、数据和集成设计功能测试方案或用例。
API 测试 api-testing 为 REST、GraphQL 或 gRPC 接口设计 API 测试方案或用例。
手动/探索性测试 manual-testing 使用章程、启发式方法和会话记录规划手动或探索性测试。
移动端测试 mobile-testing 覆盖功能、兼容性、性能、网络和安全的 iOS/Android 测试。
可访问性测试 accessibility-testing 按 WCAG、键盘导航和辅助技术场景设计可访问性测试。
安全测试 security-testing 围绕 OWASP 风险、漏洞扫描和渗透场景设计安全测试。
发布、缺陷与报告
名称 目录 主要用途
缺陷上报 bug-reporting 编写包含复现步骤、环境信息和证据的清晰缺陷报告。
测试报告 test-reporting 生成包含摘要、指标、缺陷分析和风险评估的测试报告。
测试报告评审 test-report-review 核对测试报告与执行、缺陷和范围证据,形成 Human 待决的 AI 建议
Engineering QA Skills — 质量工程能力
需求与质量左移
名称 目录 主要用途
验收标准评审 acceptance-criteria-review 评审验收标准的可验证性与缺口
需求缺口分析 requirement-gap-analysis 识别需求信息缺口、冲突与影响
质量风险分析 quality-risk-analysis 基于证据识别并排序质量风险
可测试性分析 testability-analysis 评估需求或设计的可测试性与阻碍
需求质量评审 requirement-quality-review 在测试设计前,从完整性、清晰度、可验证性、可行性、范围和证据质量评审需求
需求歧义分析 requirement-ambiguity-analysis 识别角色、对象、条件、数量、时间、状态和验收语句中的歧义
需求一致性分析 requirement-consistency-analysis 比较跨来源术语、标识、格式、状态、规则和行为的一致性
需求冲突检测 requirement-conflict-detection 识别同一适用范围内互斥的需求规则并保留 Human 决策边界
需求可追踪性分析 requirement-traceability-analysis 建立需求与验收、设计、代码、测试、缺陷和证据的双向追踪
业务规则提取 business-rule-extraction 从需求、政策和流程材料中提取有来源、有范围、有例外的业务规则
技术设计质量评审 technical-design-quality-review 从边界、失败、数据、安全、性能和可运维性评审技术设计
API 设计质量评审 api-design-quality-review 评审 API 契约、错误、认证、幂等、分页、版本和消费者影响
数据库设计质量评审 database-design-quality-review 评审模型、约束、索引、生命周期、并发、迁移和恢复设计
可观测性设计评审 observability-design-review 评审信号、维度、语义、告警、隐私、基数、采样和保留策略
错误处理设计评审 error-handling-design-review 评审失败模式、重试、降级、传播、一致性和遥测设计
测试范围分析 test-scope-analysis 基于目标、风险、依赖和证据明确测试纳入、排除与深度
测试缺口分析 test-gap-analysis 从需求、风险、变更、缺陷和测试证据中发现未被充分保护的测试义务
基于风险的测试 risk-based-testing 将风险证据转换为测试优先级、方法、深度和范围取舍
边界场景发现 edge-case-discovery 从需求、状态、时间、资源和平台证据中发现边界候选
负向场景发现 negative-scenario-discovery 从产品证据中发现非法、拒绝、失败、降级和恢复候选
可靠性与安全
名称 目录 主要用途
可靠性测试 reliability-testing 围绕可靠性目标、故障模式和证据准备形成分析候选。
韧性测试 resilience-testing 分析降级、韧性和有限恢复证据。
混沌测试 chaos-testing 设计受控故障注入假设和安全边界。
故障切换测试 failover-testing 识别主备切换路径、触发条件和恢复证据。
恢复测试 recovery-testing 定义恢复目标、证据缺口和验证准备。
重试测试 retry-testing 分析重试安全、幂等、退避和耗尽行为。
超时测试 timeout-testing 分析超时预算、取消和下游边界。
熔断器测试 circuit-breaker-testing 分析熔断器状态、降级和恢复证据。
依赖故障测试 dependency-failure-testing 分类依赖故障并审查隔离与兜底证据。
灾备测试 disaster-recovery-testing 记录灾备目标、Runbook 和恢复验证准备。
身份认证测试 authentication-testing 审查身份凭证、生命周期和认证失败证据。
授权测试 authorization-testing 审查主体、资源、动作和权限边界决策。
会话安全测试 session-security-testing 审查会话生命周期、固定、过期和撤销风险。
API 安全测试 api-security-testing 审查 API 攻击面和安全契约边界。
安全需求审查 security-requirement-review 审查安全需求的可追踪性和可测试性。
威胁建模 threat-modeling 建立资产、信任边界、威胁和缓解模型。
敏感信息暴露审查 secrets-exposure-review 审查敏感信息位置、生命周期和暴露证据。
质量工程与效能
名称 目录 主要用途
质量门禁设计 quality-gate-design 定义有证据的通过、阻塞、升级和例外规则
质量指标设计 quality-metrics-design 定义指标、分子分母、数据源、时效和解释边界
质量仪表盘设计 quality-dashboard-design 设计决策问题、面板、钻取、刷新和告警语义
质量债务分析 quality-debt-analysis 盘点质量债务来源、影响、年龄、所有人和偿还权衡
质量成熟度评估 quality-maturity-assessment 用证据锚点评估质量实践成熟度和改进缺口
测试有效性分析 test-effectiveness-analysis 分析测试信号、风险覆盖、漏检限制和验证计划
自动化投资回报分析 automation-roi-analysis 比较自动化建设、运行、维护成本与收益假设
测试瓶颈分析 testing-bottleneck-analysis 定位测试等待、依赖、容量、交接和约束证据
回归优化 regression-optimization 在风险、反馈时间、并行、缓存和维护之间优化回归范围
CI 测试优化 ci-test-optimization 优化 CI 阶段、反馈、波动、资源、缓存和分片
测试运行时间优化 test-runtime-optimization 基于剖析和基线优化慢测试、初始化、清理、并行和隔离
测试维护成本分析 test-maintenance-cost-analysis 分析变更频率、修复工时、波动成本、所有权和可维护性
质量生产力指标 quality-productivity-metrics 定义质量与交付生产力指标并保留归因和操纵边界
开发与持续集成
名称 目录 主要用途
代码审查 code-review 对 PR 或 Diff 进行风险驱动的代码审查,输出 P0/P1/P2 问题与可执行修复建议。
变更影响分析 change-impact-analysis 分析变更的质量影响范围与风险
PR 测试影响分析 pr-test-impact-analysis 从 PR 或 Diff 分析测试影响
API 契约测试 api-contract-testing 验证 API 契约兼容性与变更风险
自动化测试 automation-testing 使用 POM、数据驱动或 BDD 等模式设计自动化测试方案。
API Schema 校验 api-schema-validation 将 API Schema 与请求、响应和版本证据进行可追溯比对。
API 负向测试 api-negative-testing 从契约和错误证据设计非法输入、拒绝与降级候选。
API 幂等性测试 api-idempotency-testing 围绕重复请求、重试、幂等键和副作用设计验证候选。
API 分页测试 api-pagination-testing 根据分页、排序和数据集证据识别边界、连续性和一致性风险。
API 限流测试 api-rate-limit-testing 根据配额、窗口、突发和恢复证据设计限流候选。
API 版本兼容性测试 api-version-compatibility-testing 从版本契约、旧客户端和弃用证据评估兼容性风险。
API 错误契约测试 api-error-contract-testing 评审错误状态码、错误码、字段结构和脱敏行为的一致性。
测试数据与自动化实现
名称 目录 主要用途
测试数据需求分析 test-data-requirement-analysis 在测试设计或数据生成前分析实体、关系、隐私、生命周期、初始化、清理和阻塞项
测试数据生成 test-data-generation 设计安全且具代表性的测试数据
Bruno 接口自动化 api-test-bruno 解析多格式 API 定义,生成可执行回归的 Bruno 集合。
Postman API 测试 api-test-postman 设计 Postman 集合、环境、脚本和可用 Newman 执行的 API 回归方案。
Pytest 接口自动化 api-test-pytest 解析多格式 API 定义并生成 Pytest 接口自动化方案。
RestAssured 接口自动化 api-test-restassure 解析多格式 API 定义并生成 Rest Assured Java 测试类。
Supertest 接口自动化 api-test-supertest 解析多格式 API 定义并生成可执行的 Supertest 脚本。
Selenium UI 自动化测试 ui-test-selenium 设计 Selenium WebDriver UI 自动化方案,覆盖稳定定位、等待、Page Object、Grid 和 CI 执行。
Playwright UI 自动化测试 ui-test-playwright 设计 Playwright Test 套件,覆盖 fixtures、projects、trace、截图、API+UI 组合和 CI 报告。
TestCafe UI 自动化测试 ui-test-testcafe 设计 TestCafe UI 自动化方案,覆盖 fixture、selector、role、浏览器矩阵和报告。
Cypress UI 自动化测试 ui-test-cypress 设计 Cypress e2e 与组件测试方案,覆盖 commands、fixtures、网络桩和 CI 报告。
Puppeteer UI 自动化测试 ui-test-puppeteer 设计 Puppeteer 自动化方案,覆盖 Chromium 检查、截图、PDF、网络拦截和 CDP 场景。
WebdriverIO UI 自动化测试 ui-test-webdriverio 设计 WebdriverIO 套件,覆盖配置、services、runner、Page Object、capabilities 和 reporters。
UI 测试策略 ui-test-strategy 从用户旅程、界面状态、平台差异和风险证据形成 UI 测试策略。
UI 测试选择器评审 ui-test-selector-review 基于 DOM、组件语义和测试代码评审选择器稳定性与可维护性。
UI 测试等待策略评审 ui-test-wait-strategy-review 从异步状态和可观察条件评审等待、轮询与超时策略。
视觉回归测试 visual-regression-testing 围绕基线、视口、字体、数据和差异阈值设计视觉回归候选。
跨浏览器测试 cross-browser-testing 根据用户分布、引擎、版本、设备和缺陷证据选择兼容性覆盖。
测试执行与回归智能
名称 目录 主要用途
不稳定测试分析 flaky-test-analysis 从运行证据分析间歇性测试失败
回归范围分析 regression-scope-analysis 按风险定义回归范围和排除依据
回归测试选择 regression-test-selection 从测试资产选择最小风险覆盖回归集
AI 辅助测试 ai-assisted-testing 使用 AI 辅助测试数据生成、根因分析和优先级判断等工作。
AI 生成测试评审 ai-generated-test-review 审查 AI 生成测试是否具备真实回归保护,识别伪测试、弱断言和缺失业务结果。
测试代码评审 test-code-review 基于测试代码和运行证据识别断言、隔离、夹具、确定性和维护风险。
变异测试分析 mutation-testing-analysis 根据变异算子和存活结果分析测试敏感性,不虚构质量分数。
Mock 质量评审 mock-quality-review 评审 mock 的契约一致性、逼真度、过度模拟和漂移风险。
测试套件健康度分析 test-suite-health-analysis 基于耗时、波动、重复、隔离和维护证据评估测试套件健康度。
性能工程与容量决策
名称 目录 主要用途
性能测试 performance-testing 面向负载、压力、突发、耐久或容量目标设计性能测试。
k6 性能测试 performance-test-k6 规划 k6 的负载、压力、突发或浸泡测试范围、脚本与执行入口。
Gatling 性能测试 performance-test-gatling 规划 Gatling 性能测试范围、模拟场景和可执行入口。
JMeter 性能测试 performance-test-jmeter 设计 JMeter 测试计划,覆盖 Thread Group、Sampler、数据集、断言、Timer、CLI 执行和 HTML 报告。
性能负载建模 performance-workload-modeling 建立基于证据的性能负载模型
性能结果分析 performance-result-analysis 解释性能结果、证据质量与风险
性能瓶颈分析 performance-bottleneck-analysis 形成可验证的性能瓶颈假设
性能回归分析 performance-regression-analysis 比较版本性能证据并评估回归风险
容量规划分析 capacity-planning-analysis 评估容量需求、余量和规划风险
复盘与持续改进
名称 目录 主要用途
根因分析 root-cause-analysis 形成并验证基于证据的根因假设
日志分析 log-analysis 从日志提取时间线、异常和证据
Production Quality Skills — 生产质量能力
发布与生产验证
名称 目录 主要用途
生产验证 production-verification 基于证据规划或评估生产验证
生产运行与事故响应
名称 目录 主要用途
生产事故分析 production-incident-analysis 分析生产事故证据、影响与后续动作
分布式 Trace 分析 distributed-trace-analysis 从分布式 Trace 关联调用链和证据
指标异常分析 metrics-anomaly-analysis 识别指标异常、基线与排查证据
AI Native QA Skills — AI 原生质量能力
AI 功能需求与风险
名称 目录 主要用途
AI 功能测试 ai-feature-testing 设计 AI 功能行为、风险和边界测试
LLM 与 Prompt 评测设计
名称 目录 主要用途
LLM Eval 设计 llm-evaluation-design 设计 LLM 评测集、判定与人工复核边界
LLM 测试 llm-testing 验证 LLM 行为、失败模式和质量边界
Prompt 测试 prompt-testing 测试 Prompt 行为、边界和版本回归
RAG 质量测试 rag-quality-testing 测试 grounding、相关性、完整性、引用支持和拒答证据
RAG 检索测试 rag-retrieval-testing 分析查询变体、分块、过滤、排序、新鲜度和检索证据
LLM 幻觉测试 llm-hallucination-testing 按声明和来源证据识别无支持断言并评估拒答
LLM 一致性测试 llm-consistency-testing 比较重复输入、版本因素、不变量和输出方差

prompt-regression-testing 是 prompt-testing 内名为 prompt-regression 的增强模式,不创建别名目录。

Agent、工具与安全测试
名称 目录 主要用途
AI Agent 测试 ai-agent-testing 测试 AI Agent 的目标、状态、恢复和安全边界
Agent 工具调用测试 agent-tool-testing 验证 Agent 工具调用契约、授权和副作用边界
Prompt Injection 测试 prompt-injection-testing 设计 AI 系统 Prompt 注入防护测试
Agent 循环测试 agent-loop-testing 测试规划-动作-观察循环、停止条件、预算和重复行为
Agent 记忆测试 agent-memory-testing 测试记忆读写、更新删除、保留、隔离、来源和遗忘
Agent 权限测试 agent-permission-testing 验证身份、工具资源范围、批准拒绝和副作用边界
Agent 故障恢复测试 agent-failure-recovery-testing 分析故障分类、重试回退、升级、状态一致性和用户通知
长运行 Agent 测试 agent-long-running-testing 测试检查点、心跳、恢复取消、重复提交、超时和资源生命周期
多 Agent 测试 multi-agent-testing 分析委派、协调、共享状态、冲突、所有权和终止
AI 安全测试 ai-safety-testing 审查安全政策、滥用、拒答重定向、隐私和升级边界

Skill Engineering(横向治理)

名称 目录 主要用途
Skill 变更验证 skill-change-verification 按变更范围选择验证证据,并区分静态、评测和运行时结论。
Skill 质量审查 skill-quality-review 审查完整 Skill 包的工程契约、独立安装、双语一致性和 Eval 准备度。
Skill 评测 skill-evaluation 设计、运行、解释和报告 evidence-bounded Skill 评测。
Skill 文案契约审查 skill-prose-review 审查 Skill、Prompt 与文档的可执行契约、边界和证据要求。
过程性文案清理 skill-prose-trim 清理文案中的审查和设计过程残留,同时保留当前状态契约。

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。

文档导航

文档 用途
文档导航 按任务和主题浏览项目文档
AGENTS.md Coding Agent 约定与质量检查
skills-index.md 全量技能索引
skills-composition.md v1.5.2 五条结构化路由、主/辅 Skill 和导航关系
Skill Quality Engineering Toolkit Skill 质量工程工具包与评测入口
Skills CLI 集成指南 CLI 分发约定、兼容性验证与安装边界
QA_SKILLS_EVOLUTION_ROADMAP.md 四层能力演进与研发测试阶段地图
DOCUMENTATION_POLICY.md 中文优先的双语文档治理策略
SKILL_GOVERNANCE_V1.md v1.0 源代码治理基线与当前 169 对静态记录入口(早期基线 79 对;不代表运行质量)
PHASE_0_V1_4_CLOSEOUT.md v1.4 35 张 Project 卡的证据收口与版本边界(不代表发布批准)
BILINGUAL_CONSISTENCY_CONTRACT.md 中英文路径、入口、Catalog 与链接一致性契约
QUALITY_SCORE_EVAL_CONTRACT.md 九维评分与最低 Eval 工件标准
WORKFLOW_EVAL_INSTALL_SYNC.md 14 个 testing-workflows 包的双语、Eval 与安装入口同步清单(含安装命令)
PHASE_1_REQUIREMENTS_QUALITY.md v1.1 Phase 1 前五个需求质量 Skill 的范围、卡片、证据和验收边界
SKILL_EVAL_RULES.md codex exec --json trace 的 20 条本地确定性 Skill 评测规则
skills/DIRECTORY_GUIDE.md 目录与命名规范
skills/SKILL_AUTHORING.md 编写与 skill-up 评测约定
scripts/INSTALL_SKILLS.md CLI、仓库脚本、快捷安装器与手动复制的中文安装指南
FAQ.md 常见问题
CONTRIBUTING.md 贡献流程
skills-graph.md 技能关系图(参考)

社区推荐的外部 Skills

本栏收录社区提交的外部 Skill,供发现与参考。条目由源项目维护,不计入本仓库自身的 Skill 目录。许可证、版本和兼容性信息以链接的上游来源为准,并标注核验日期;列入本栏不代表本仓库已进行运行时评测。

Skill 类型 提交人 来源 上游信息(核验日期)
UIZZE anti-ui-slop Agent Skill / UX 质量门禁 @samuelbushi 上游目录 · 提交 Issue #3 Apache-2.0 · v1.3.1 · 上游列出 Claude Code、Codex、Cursor、GitHub Copilot(核验于 2026-10-12)
UI Verify triage-visual-changes Agent Skill / 视觉回归分流 @igrlk 上游目录 · 提交 Issue #33 MIT · UI Verify plugin v0.1.0 · 需要 UI Verify 账号(提供免费层)和 MCP 连接(核验于 2026-10-19)

贡献

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

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

许可证

本仓库采用 PolyForm Noncommercial License 1.0.0。您可以自由使用、修改和分发本软件,但仅限非商业目的(如个人学习、研究、实验、慈善机构、教育机构、公共研究组织、政府机构等用途)。

评论

暂无评论