mcpField
U
unit-test-task-generator

unit-test-task-generator

github.com/nextstage-brasil测试与质量040 次安装4 天前更新
代码仓库

关于 unit-test-task-generator

用于规划后端单元测试和 HTTP 集成测试的 Skill,会为功能创建任务文件。它依据现有实现任务和需求数据模型,列出组件测试场景、必需模式、依赖关系及运行命令。

主要功能

  1. 01规划单元测试和 HTTP 集成测试
  2. 02覆盖请求、服务、模型和控制器
  3. 03纳入租户隔离场景
  4. 04将测试任务关联到实现任务
  5. 05指定测试文件和运行命令

适用场景

  1. 01为某项功能规划后端测试
  2. 02在 CRUD 测试计划中加入跨租户检查
  3. 03实现前准备测试任务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nextstage-brasil/skills --skill unit-test-task-generator

安装后在 Claude Code 中输入/unit-test-task-generator确认已加载。

附带文件evals/evals.json

详细介绍

单元测试任务生成器

为某个功能创建 task-NNN-*.md,涵盖后端单元测试和 HTTP 集成测试。

范围

  • **规划:**此技能(任务 Markdown)
  • **执行:**按任务实现测试 — 使用 create-backend-tests 或实现工作流

测试框架发现

存在时,加载 {harness}/rules/backend-tests-rules.mdc 和 backend-rules.mdc。

输入

  • 要覆盖的功能
  • 已生成的后端实现任务列表
  • requirements.md 数据模型

后端测试金字塔

        [ E2E ]  ← e2e-test-generator
     [ Integration ]  ← Controller/HTTP tests
    [ Unit tests ]  ← Service, FormRequest, Model, Rules

测试内容

组件类型重点
FormRequest单元测试有效/无效字段、租户外键规则
Service单元测试业务逻辑、模拟对象
Model单元测试作用域、类型转换、关系
Controller集成测试状态码、响应结构、身份验证、401/403
租户作用域集成测试跨租户 P0 — 对其他公司绝不能返回 200

输出结构

参见技能正文中的工厂模式 — 包含:

  • 摘要和详细测试计划(不得重复)
  • 后端根目录 — {product_root}/backend/(单体仓库)或检测到的棕地项目路径
  • 位于 tests/Unit/ 和 tests/Feature/ 下的文件
  • 按组件划分的场景检查清单
  • 强制模式:RefreshDatabase、工厂、响应结构、跨租户用例
  • 运行命令 — 在 Docker 中运行 vendor/bin/phpunit --testdox --stop-on-failure --stop-on-error,超时时间为 120s(参见 create-backend-tests)
  • 项目尚无 tests/ 时的引导说明:执行者必须先运行 create-backend-tests Phase 0,再创建测试类

依赖项

任务必须引用其覆盖的后端实现任务 task-NNN.md。

规则

  • 租户范围 CRUD 任务若仅包含成功路径,则在缺少跨租户 P0 测试时不完整
  • 不要让测试连接生产数据库
  • 与项目的测试运行命令保持一致 — PHPUnit:在 Docker 中运行 vendor/bin/phpunit --testdox --stop-on-failure --stop-on-error,超时时间为 120s

相关技能

  • task-generator — 先生成实现任务
  • create-backend-tests — 执行和引导
  • e2e-test-generator — UI 覆盖

评论

支持 Markdown