mcpField
U
unit-test-task-generator

unit-test-task-generator

github.com/nextstage-brasilテスト・品質040 回インストール4 日前に更新
リポジトリ

unit-test-task-generator について

バックエンドのユニットテストと HTTP 統合テストを計画し、機能に対応するタスクファイルを作成するスキルです。既存の実装タスクと要件のデータモデルをもとに、コンポーネント別シナリオ、必須パターン、依存関係、実行コマンドを定めます。

主な機能

  1. 01ユニットテストと HTTP 統合テストの計画
  2. 02リクエスト、サービス、モデル、コントローラーの検証
  3. 03テナント分離シナリオの追加
  4. 04テストタスクと実装タスクの関連付け
  5. 05テストファイルと実行コマンドの指定

活用シーン

  1. 01機能のバックエンドテスト計画
  2. 02CRUD テスト計画へのテナント間チェック追加
  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

詳細

ユニットテストタスクジェネレーター

機能を対象とするバックエンドのユニットテストと 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 のカバレッジ

コメント