SuperAPI AI 工具集

testing-best-practices

测试与质量

查看项目

更新于 10-16 02:06

技能介绍

Testing Best Practices 是一套面向 QA 与测试工作的实践指南技能,用于把产品行为、需求和代码路径转化为有用的检查。它强调的核心不是某个具体框架,而是测试纪律。

用途 该技能适用于手工测试用例、测试计划、覆盖率审查、自动化场景、单元测试、Playwright 浏览器与组件集成测试、定位器,以及 /unit-test-grill、/integration-test-grill、/testcase-grill 等规划模式。其中心思想包括:从用户可见或公开契约出发,明确什么必须工作、什么可能失败、什么绝不能发生;按风险选择合适的测试形式;让每个检查都证明有意义的行为、需求、分支、状态转换、错误路径或清理保证;保持覆盖率聚焦,独立维度分开测试,避免嘈杂的笛卡尔积,跳过只重复测试平台的任意边界值;在添加新结构前先阅读附近测试、现有 QA 产物、产品流程、schema 和自动化约定,以保留项目现实;把集成测试定位器和测试数据视为需要维护的测试 API,同步修改 schema、实现和受影响的检查。

主要能力 技能提供了一套规则映射。单元测试方面,先读 unit-test-conventions,再按主题选择规则:unit-test-function 关注公开输入、自有转换、分支、错误和异步协作者边界;unit-test-react-hook 关注公开 hook 契约、变化参数、异步工作、清理和浏览器/监听器行为;unit-test-react-component-standalone 关注独立组件 DOM、props、state、交互和可访问性;unit-test-react-component-compound 关注公开部件及其之间的 state、context、行为和可访问性关系;unit-test-grill 是 /unit-test-grill 的场景规划模式,分为待改进的现有测试和待创建的新测试。

集成测试方面,先读 integration-test-conventions,再按需选择:integration-test-browser 用于需要导航、浏览器自有状态、应用启动或其他完整浏览器边界的场景;integration-test-component 用于真实挂载的功能边界、包装器、provider 和可观察的组件集成行为;integration-test-server 用于公开服务端入口和服务编排;integration-test-mocks 用于场景自有 mock 状态、case ID、handler 和同目录文件结构;integration-test-locator-testids 用于语义 test-ID schema、复用、生成常量以及条件性 @siberiacancode/testids 用法;integration-test-setup 用于测试用例前置条件、组件包装器、路由和查询状态、挂载与就绪;integration-test-grill 是测试用例驱动的自动化规划,分为待改进的现有自动测试和待创建的浏览器或组件测试。

测试用例方面,先读 testcase-conventions,再按需选择:testcase-file-structure 关注文件夹和文件归属、覆盖率重复以及子屏幕和可复用块的位置;testcase-naming 关注点分隔层级、精确接口标签以及加载、空列表和数据用例的固定形式;testcase-content 关注原子用例、面向用户的操作、具体预期结果以及设计、功能、数据检查的划分;testcase-preconditions 关注用例文件、文件夹和全局前置条件范围;testcase-grill 是 /testcase-grill 的用例规划模式,分为待改进的现有用例和待创建的新用例。

使用方式 先识别测试目标:手工 QA、测试用例设计、覆盖率审查、自动化规划、自动化测试实现或集成测试设计。再识别被测对象:产品流程、需求、API、数据状态、函数、UI 行为、hook、组件或跨组件集成。然后选择与请求匹配的输出格式:手工 QA 写可执行测试用例或优先级清单;自动化写稳定场景或代码级测试。单元测试先读共享约定,再精确读取与被测代码匹配的主题规则;浏览器 API 或监听器 hook 仅在该行为存在时读取 hook 规则中链接的参考。集成测试先读共享约定,再精确读取所选浏览器或组件边界、mock、定位器或 grill 模式所需的规则。仓库存储的测试用例先读测试用例约定,再按任务精确读取对应规则:选择或重组文件时读结构,写名称时读命名,写步骤和预期结果时读内容,添加或移动 setup 时读前置条件,在写入前列出用例时读 grill 规则。

自动化测试默认值 现有仓库约定优先于通用测试偏好。先检查同一模块的测试,再检查最接近的可比测试、相邻层测试、现有 helper,最后才看实现。模仿最接近的可用模式,做最小结构改动;除非可比测试已使用或正确性要求,否则不要重新设计测试套件或添加新抽象。仅从明确行为、项目通常覆盖的实现分支、类似测试、用户需求、回归或既定覆盖模式中添加场景。当没有相关项目约定时,使用 Should <observable behavior>、同目录测试、直接 setup,forEach 仅用于真正重复的用例,组合用例仅在维度交互时使用。

适用场景 该技能适用于:创建手工测试用例、冒烟检查、回归套件、验收场景或探索性章程;生成、修订、审查或重组仓库测试用例目录中的结构化测试用例;规划或审查应用行为的自动化覆盖;为代码添加或审查自动化测试;查找缺失的行为覆盖、分支覆盖、状态转换、清理检查或错误路径;决定测试文件或 QA 清单中检查的命名、顺序和范围;创建或审查集成测试定位器,包括语义名称、schema 路径、JSX 属性和受影响的检查;调用 /unit-test-grill 把代码行为转化为清单而不写测试代码;调用 /integration-test-grill 把已确认的产品用例映射到浏览器或组件自动化而不写测试代码;调用 /testcase-grill 把页面或块转化为自有测试用例列表而不写入目录。

限制 资料未提供该技能的具体收费、价格、平台支持范围、效果数据或安装命令。完整编译概览可参见 AGENTS.md。