关于 unit-test-task-generator
用于规划后端单元测试和 HTTP 集成测试的 Skill,会为功能创建任务文件。它依据现有实现任务和需求数据模型,列出组件测试场景、必需模式、依赖关系及运行命令。
主要功能
- 01规划单元测试和 HTTP 集成测试
- 02覆盖请求、服务、模型和控制器
- 03纳入租户隔离场景
- 04将测试任务关联到实现任务
- 05指定测试文件和运行命令
适用场景
- 01为某项功能规划后端测试
- 02在 CRUD 测试计划中加入跨租户检查
- 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-testsPhase 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