unit-test-task-generator について
バックエンドのユニットテストと HTTP 統合テストを計画し、機能に対応するタスクファイルを作成するスキルです。既存の実装タスクと要件のデータモデルをもとに、コンポーネント別シナリオ、必須パターン、依存関係、実行コマンドを定めます。
主な機能
- 01ユニットテストと HTTP 統合テストの計画
- 02リクエスト、サービス、モデル、コントローラーの検証
- 03テナント分離シナリオの追加
- 04テストタスクと実装タスクの関連付け
- 05テストファイルと実行コマンドの指定
活用シーン
- 01機能のバックエンドテスト計画
- 02CRUD テスト計画へのテナント間チェック追加
- 03実装前のテストタスク準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill unit-test-task-generatorインストール後、Claude Code で/unit-test-task-generatorを入力して読み込まれたか確認します。
同梱ファイルevals/evals.json
詳細
ユニットテストタスクジェネレーター
機能を対象とするバックエンドのユニットテストと HTTP 統合テスト用に、task-NNN-*.md を作成します。
範囲
- 計画: このスキル(タスクの 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 | ユニット | 有効/無効なフィールド、テナント FK ルール |
| 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を実行、タイムアウトは 120 秒(create-backend-testsを参照) - プロジェクトにまだ
tests/がない場合のブートストラップに関する注記:実行担当者はテストクラスの作成前にcreate-backend-testsのフェーズ 0 を実行する必要があります
依存関係
タスクでは、対象とするバックエンド実装の task-NNN.md を参照する必要があります。
ルール
- テナントスコープの CRUD について、ハッピーパスのみのタスクは、テナント間の P0 がなければ不完全です
- 本番データベースをテスト対象にしないでください
- プロジェクトのテストランナーコマンドに合わせます — PHPUnit の場合:Docker 内で
vendor/bin/phpunit --testdox --stop-on-failure --stop-on-errorを実行、タイムアウトは 120 秒
関連スキル
task-generator— 先に実装タスクを作成create-backend-tests— 実行とブートストラップe2e-test-generator— UI のカバレッジ
コメント
Markdown 対応