qa-start

用途

qa-start 是一个按顺序执行的启动器技能，用于在项目中完全没有 QA 基础时引导建立 QA。它适用于以下情况：

全新项目，没有任何测试基础设施。
加入一个完全没有 QA 设置的既有代码库——代码较旧，但质量工作从未被正式化。这种情况仍使用 qa-start，而不是 qa-project-bootstrap（后者用于加入一个已经有测试的团队）。
在 QA 被忽视后重建——测试被删除、覆盖率崩塌、没有策略。此时是从基础开始重建 QA。

如果代码库已经有真实的测试套件，而你是正在融入团队的 QA 工程师，则应改用 qa-project-bootstrap。

快速路径

选择你的入口点——凡是已有产物存在的步骤都可以跳过。

情况	起点
完全没有 QA（没有上下文文件、没有策略、没有计划）	步骤 1
.agents/qa-project-context.md 已填充	跳过步骤 1——调用 test-strategy（步骤 2）
上下文文件和策略文档都已存在	跳过步骤 1 和 2——调用 test-planning（步骤 3）
三步都已完成——接下来做什么？	见步骤 3 之后
QA 工程师融入一个已有测试的既有团队	不使用本技能——见 qa-project-bootstrap

主要能力与使用方式

步骤 1：捕获项目上下文

技能：qa-project-context

在你的项目根目录创建 .agents/qa-project-context.md。该文件记录你的技术栈、测试框架、CI/CD 流水线、环境、覆盖率目标、风险区域和团队结构。后续每个技能都会读取它，因此不会重复询问相同的问题。

做法：调用 qa-project-context 并完成其发现性问题。该技能会交互式地走完每个部分，尽可能从仓库中发现信息，并写入该文件。
完成条件：.agents/qa-project-context.md 存在于项目根目录且所有部分均已填写。它是后续一切工作的唯一事实来源。

步骤 2：创建测试策略

技能：test-strategy

产出一份策略文档，定义项目如何对待质量：测试金字塔（单元、集成、E2E 测试在你的产品中各自合适比例）、进入与退出标准、工具选择、环境覆盖，以及 CI 和发布的质量门禁。

做法：在步骤 1 完成后调用 test-strategy。它会自动读取上下文文件，不会重新询问其中已回答的内容。
完成条件：你有一份策略文档（例如 strategy.md），涵盖测试金字塔的理由、带说明的工具选择、CI 与发布的质量门禁，以及每种测试类型的进入/退出标准。一页清晰的决策胜过一份庞杂的模板。

步骤 3：构建首个测试计划

技能：test-planning

把策略转化为首个冲刺或发布的可执行计划。将功能映射到测试用例、分配工作量，并决定先覆盖什么、推迟什么。

做法：在步骤 2 之后调用 test-planning。它消费步骤 2 的策略和步骤 1 的上下文。在提示时提供功能列表或冲刺范围。
完成条件：你有一份测试计划（例如 plan.md），其中功能已映射到测试用例、覆盖率优先级已设定、工作量已估算、范围边界清晰。这是团队据以执行的产物。

适用场景与后续动作

完成步骤 3 后，你已拥有基础：上下文、策略和第一份计划。接下来的动作取决于你的技术栈——本启动器不是最后一步。

首批自动化测试：使用 playwright-automation 或 cypress-automation，针对风险最高的流程编写首批 E2E 测试。
CI 集成：使用 ci-cd-integration 让测试在每次拉取请求上运行。
跟踪质量：测试套件运行后使用 qa-metrics，定义健康状态的含义以及如何随时间衡量。

qa-start vs qa-project-bootstrap vs qa-do

最常见的路由混淆，在此集中回答：

qa-start——在不存在 QA 的地方启动 QA。新项目，或 QA 被删除后重建。顺序：上下文 → 策略 → 首个计划。输出是 QA 基础。
qa-project-bootstrap——为加入已有测试的既有团队的 QA 工程师提供的 30 天融入计划。涵盖团队流程、入职时间线，以及对既有测试套件的审计。应在基础已存在之后使用，而不是用来创建基础。
qa-do——当“我该用哪个技能？”没有任何明确匹配时的最后手段路由器。如果你已知道自己没有 QA，跳过它并运行 qa-start。

一个全新项目、没有任何 QA——即使在旧代码库上——始终是 qa-start，绝不是 qa-project-bootstrap。

固定为手动命令

可随时从 Claude Code 的 /skills 菜单重新运行。

要将此技能固定为仅手动命令，可在 frontmatter 中添加 disable-model-invocation: true，或通过 .claude/settings.local.json 中的 skillOverrides 进行设置。

注意：在某些 Claude Code 构建中，disable-model-invocation: true 也会抑制手动斜杠命令（参考 anthropics/claude-code#26251）。如果你仍想手动调用 /qa-start，请将 skillOverrides 状态设为 user-invocable-only。

限制

资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。

技能介绍

用途