w-api-test 是 blockmatic/basilic-skills 中的一项技能,主要用于为已有测试装置补充 API 测试,从公开 HTTP 接口层面验证服务行为。
用途 该技能的目标是新增能够模拟公开 HTTP 行为的 API 测试,并让这些测试运行在仓库已有的测试装置(harness)之上。它面向的是端点级别的接口验证,而非内部实现细节。
主要能力
- 通过公开接口测试端点,使用本仓库的 API 装置或 Playwright 装置。
- 覆盖所请求的操作、授权拒绝(authz denials)以及符合契约结构的响应。
- 与已有的 *.test.ts 或 e2e 规格(specs)以及 API 测试 MDX 文档配合使用。
使用方式
- 阅读 API 测试的 MDX 文档以及现有的 *.test.ts 或 e2e 规格文件。
- 针对请求的操作、授权拒绝情形和契约响应形状编写测试覆盖。
- 使用 package scripts 中提供的沙箱或本地服务器运行测试,不要访问生产环境,不要硬编码密钥。
- 测试完成后清理所创建的资源。
- 运行文档中记录的 API 或 e2e 命令来执行这些测试。
- 如果行为或命令发生变化,参考 /w-docs 文档。
适用场景
- 为后端服务补充接口契约测试与权限校验测试。
- 在本地或沙箱环境中验证 HTTP 端点的公开行为。
- 在已有 API 或 Playwright 测试装置基础上扩展测试覆盖。
限制与注意事项
- 明确不得访问生产环境。
- 不得硬编码密钥。
- 需依赖仓库内已有的测试装置、MDX 文档与测试命令;具体命令以实现仓库为准。
当前资料未提供的信息:该技能的安装命令、支持的平台、是否收费及价格、详细实现机制、官方文档全文等。