关于 ns-pm-unit-test-task-generator
用于规划后端单元测试和 HTTP 集成测试的技能,可为功能生成 Markdown 任务文件。它关联已有实现任务,并重点覆盖租户隔离场景。
主要功能
- 01生成后端测试任务文件
- 02规划单元与 HTTP 集成测试
- 03覆盖请求、服务、模型和控制器
- 04纳入跨租户场景
- 05关联实现任务依赖
适用场景
- 01规划后端功能的测试
- 02在测试计划中加入租户隔离检查
- 03在实现测试前准备 PHPUnit 任务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill ns-pm-unit-test-task-generator安装后在 Claude Code 中输入/ns-pm-unit-test-task-generator确认已加载。
附带文件evals/evals.json
详细介绍
单元测试任务生成器
为涵盖某个功能的后端单元测试和 HTTP 集成测试创建 task-NNN-*.md。
范围
- **规划:**此技能(任务 Markdown)
- **执行:**按任务实现测试 — 使用
ns-code-backend-tests或实现工作流
测试框架发现
如果存在,请加载 {harness}/rules/backend-tests-rules.mdc 和 backend-rules.mdc。
输入
- 要覆盖的功能
- 已生成的后端实现任务列表
requirements.md数据模型
测试金字塔(后端)
[ E2E ] ← ns-pm-e2e-test-task-generator
[ Integration ] ← Controller/HTTP tests
[ Unit tests ] ← Service, FormRequest, Model, Rules
测试内容
| 组件 | 类型 | 重点 |
|---|---|---|
| FormRequest | 单元测试 | 有效/无效字段、租户外键规则 |
| Service | 单元测试 | 业务逻辑、模拟对象 |
| Model | 单元测试 | 作用域、类型转换、关联关系 |
| Controller | 集成测试 | 状态、响应结构、身份验证、401/403 |
| 租户作用域 | 集成测试 | 跨租户 P0 — 对其他公司绝不返回 200 |
输出结构
参见技能正文中的工厂模式 — 包含:
- 摘要和详细测试计划(不要重复)
- 后端根目录 —
{product_root}/backend/(monorepo)或检测到的棕地项目路径 tests/Unit/和tests/Feature/下的文件- 各组件的场景检查清单
- 强制模式:RefreshDatabase、工厂、响应结构、跨租户用例
- 运行命令 — 在 Docker 中运行
vendor/bin/phpunit --testdox --stop-on-failure --stop-on-error,超时 120s(参见ns-code-backend-tests) - 项目尚无
tests/时的引导说明:执行者必须先运行ns-code-backend-testsPhase 0,再创建测试类
依赖
任务必须引用其所覆盖的后端实现任务 task-NNN.md。
规则
- 对租户范围 CRUD 只覆盖成功路径的任务,若缺少跨租户 P0,则不完整
- 不要让测试连接生产数据库
- 遵循项目的测试运行命令 — PHPUnit:在 Docker 中运行
vendor/bin/phpunit --testdox --stop-on-failure --stop-on-error,超时 120s
相关技能
ns-sdd-task-generator— 先生成实现任务ns-code-backend-tests— 执行和引导ns-pm-e2e-test-task-generator— UI 覆盖
评论
支持 Markdown