SuperAPI AI 工具集

beaver-build

测试与质量

查看项目

更新于 10-15 17:22

技能介绍

Beaver Build 是一套面向测试编写与评审的技能流程,目标是把缺陷挡在进入生产环境之前。它用“水獭筑坝”的比喻组织工作,核心阶段为 SURVEY(调研)、GATHER(收集)、BUILD(构建)、REINFORCE(加固)、FORTIFY(巩固)。

用途:在用户要求“写测试”“加测试”“测试这个”“确保能用”,或调用 /beaver-build、提及 beaver/筑坝时激活;也用于判断哪些代码值得测试、评审已有测试是否有效、把缺陷转为回归测试,以及评估测试是否真正带来价值。

主要能力:依据 Testing Trophy 决定测试层级(以集成测试为主,少量单元测试,少量端到端测试,静态分析始终开启);用“自信度测试”区分应跳过、轻度测试和彻底测试的内容;按 Arrange-Act-Assert 编写测试,Act 保持一行,优先使用可访问性查询 getByRole、getByLabelText、getByText,而非首先使用 getByTestId;测试命名说明失败原因,一个测试只应有一个失败理由;仅在外部边界打桩,把每个缺陷变成回归测试,测试文件与被测代码就近放置;在 API 测试中验证 Signpost 错误格式 error_code、error、error_description。

使用方式:先读 references/testing-patterns.md 与 references/grove-test-infrastructure.md,了解模式与已有工厂、模拟工具;生成模板可运行 scripts/scaffold-test.sh <type> <source-file>,类型支持 service、api、component、worker;具体测试写法参考 references/test-templates.md。发布前必须执行 pnpm install 与 gw ci --affected --fail-fast --diagnose,若失败则依据诊断修补后重跑;可选在 CI 通过后运行 npx vitest run --coverage。

适用场景:新功能写集成测试,缺陷修复先写复现测试,重构时用现有测试验证,UI 组件用 Testing Library 测试,关键用户流程用 Playwright 做 E2E,纯函数或算法做单元测试,API 端点对模拟外部服务做集成测试。

限制与反模式:不追求 100% 覆盖率的表演,不测实现细节(内部状态、私有方法),不模拟一切,不写会在安全重构后失败的测试,不对易变 UI 用快照,不搭“冰淇淋筒”(大量 E2E、少量集成、少量单元)。资料未提供具体收费、价格、支持平台或效果保证。