SuperAPI AI 工具集

qa-project-context

测试与质量

查看项目

更新于 10-16 03:41

技能介绍

用途:为整个 QA 技能库建立唯一事实来源。所有技能先读取 .agents/qa-project-context.md,其中 Risk Areas 供 risk-based-testing 与 test-strategy 使用,Conventions → Selectors 供 playwright-automation 与 test-reliability 使用,Quality Goals 供 qa-metrics 使用,Tech Stack 供所有自动化技能使用。

主要能力:先检查文件是否已存在,已填写的章节跳过;扫描仓库配置文件(如 package.json、next.config.、playwright.config.、cypress.config.、vitest.config.、jest.config.、.github/workflows/、.gitlab-ci.yml、Jenkinsfile、docker-compose.、turbo.json、pnpm-workspace.yaml、nx.json 等)检测技术栈并请用户确认,而非盲问。按章节逐段询问:Product、Tech Stack、Test Stack、CI/CD、Environments、Quality Goals、Risk Areas、Team、Conventions。

使用方式:文件不存在时创建 .agents/ 并搭建章节结构,从 Product 开始填写;存在占位符时只补未填章节;已完整时只更新变化。完成后确认路径并运行验证: test -f .agents/qa-project-context.md
&& ! grep -q '[.*]' .agents/qa-project-context.md
&& echo "context complete: file exists, no placeholders" 再检查章节数:grep -c '^## ' .agents/qa-project-context.md(期望 >= 9)。

适用场景:新项目启动 QA、为已有项目补全或更新 QA 上下文、作为 qa-start 的第一步。

限制:本技能只记录现状,不做工具推荐;唯一例外是项目完全没有测试基础设施时,在 Test Stack 中注明默认 Playwright(E2E)与 Vitest(单元)并交接给对应技能。不得留下 [方括号] 占位符,不得编造数据库或托管信息。Risk Areas 至少 3–4 条并按影响×可能性评分。质量目标须为具体数字。团队需记录实际人数与开发:QA 比例。