ln-520-test-planner

パス: ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

テスト計画オーケストレーター

タイプ: L2 コーディネーター
カテゴリ: 5XX 品質

ランタイムがスキップ／再利用の判定、ワーカーのサマリー追跡、決定的な再開を担う、ランタイムベースのテスト計画コーディネーターです。

入力

入力	必須	ソース	説明
storyId	はい	args、git ブランチ、kanban、ユーザー	処理対象のストーリー
--simplified	いいえ	args	調査（ln-521）と手動テスト（ln-522）をスキップします。自動テスト計画（ln-523）のみを実行します。ファストトラックモードで使用します。

解決方法: ストーリー解決チェーン。
ステータスフィルター: レビュー待ち

目的と範囲

• テスト計画をオーケストレーションします：調査 → 手動テスト → 自動テスト計画
• ワーカー（ln-521-test-researcher、ln-522-manual-tester、ln-523-auto-test-planner）に委任します
• 直接作業は行いません — Skill ツールを介した調整と委任のみを行います

ランタイム契約

必須の読み込み: references/coordinator_runtime_contract.md、references/test_planning_runtime_contract.md、references/test_planning_summary_contract.md、references/test_planning_worker_runtime_contract.md、references/task_plan_worker_runtime_contract.mdを読み込みます。

ランタイムファミリー：test-planning-runtime

識別子：

• ストーリー ID

フェーズ：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVERY
3. PHASE_2_RESEARCH
4. PHASE_3_MANUAL_TESTING
5. PHASE_4_AUTO_TEST_PLANNING
6. PHASE_5_FINALIZE
7. PHASE_6_SELF_CHECK

ワーカーサマリー契約：

• ln-521、ln-522、ln-523には、決定的な子runIdと正確なsummaryArtifactPathを渡します
• アーティファクトを待つ前に、子ランタイムのメタデータをチェックポイントに記録します
• 各ワーカーは、最終状態に至る前にtest-planning-workerサマリーエンベロープを書き込みます
• ln-520は自由形式のワーカーの文章ではなく、ワーカーサマリーを使用します

使用するタイミング

このスキルは、次の場合に使用してください。

• ストーリーの実装と回帰テストが完了し、包括的なテスト計画が必要な場合
• ストーリー内のすべての実装タスクが完了している場合
• テスト計画（調査 + 手動 + 自動）をすべて実施する必要がある場合

前提条件：

• ストーリー内のすべての実装タスクのステータスが「完了」
• 回帰テストに合格済み（ln-513）
• コード品質を確認済み（ln-511）

パイプラインの概要

ln-520-test-planner (Orchestrator)
    │
    ├─→ ln-521-test-researcher
    │     └─→ Posts "## Test Research: {Feature}" comment
    │
    ├─→ ln-522-manual-tester
    │     └─→ Creates tests/manual/ scripts + "## Manual Testing Results" comment
    │
    └─→ ln-523-auto-test-planner
          └─→ Creates test task via the configured tracker provider via ln-301/ln-302

ワークフロー

フェーズ 0：入力の解決

必須の読み込み: references/input_resolution_pattern.mdを読み込みます。

1. storyIdを解決: ガイドに従ってストーリー解決チェーンを実行します（ステータスフィルター：[レビュー待ち]）。

フェーズ 1：ディスカバリー

1. docs/tasks/kanban_board.mdからチーム ID を自動検出します
2. ストーリー ID を検証します

フェーズ 2：調査の委任

簡易モードの判定：

• --simplifiedフラグがあり、ストーリーに調査コメントがすでにある場合：フェーズ 2（調査）をスキップします。フェーズ 4 に進みます。
• --simplifiedフラグがあり、調査コメントがない場合：フェーズ 2 をスキップします。フェーズ 4 に進みます（ln-523が最小限のインライン調査を生成します）。

1. 調査があるか確認します：

   • トラッカーのコメントを検索して「## Test Research:」ヘッダーを探します（listComments）
   • 見つかった場合 → フェーズ 3 へ進みます

2. 調査がない場合：

   • ln-521用の決定的な子ラン入力を計算します
   • test-planning-worker-runtimeを開始し、委任の前にchild_runをチェックポイントに記録します
   • 管理対象のワーカー実行を介してln-521-test-researcherを呼び出します
   • 渡すもの：ストーリー ID
   • 完了を待ちます
   • 生成されたtest-planning-workerアーティファクトのみを読み込みます
   • 調査コメントが作成されたことを確認します

フェーズ 3：手動テストの委任

簡易モードの条件：

• --simplified フラグが指定されている場合：フェーズ 3（手動テスト）をスキップします。フェーズ 4 に進みます。

1. 手動テストの完了を確認します：

   • トラッカーのコメントで「## Manual Testing Results」ヘッダーを検索します（listComments）
   • すべての AC に合格しているものが見つかった場合は、フェーズ 4 に進みます

2. 手動テストが必要な場合：

   • ln-522 用の決定論的な子ラン入力を計算します
   • test-planning-worker-runtime を開始し、委任前に child_run をチェックポイントに記録します
   • 管理されたワーカー実行を通じて ln-522-manual-tester を呼び出します
   • 渡すもの：ストーリー ID
   • 完了を待ちます
   • 生成された test-planning-worker アーティファクトのみを読み取ります
   • 結果コメントが作成されたことを確認します

3. いずれかの AC が失敗した場合：

   • パイプラインを停止します
   • ln-500 に「手動テストに失敗しました。ストーリーの修正が必要です」と報告します

フェーズ 4：自動テスト計画の委任

1. 自動テストプランナーを呼び出します：

   • ln-523 用の決定論的な子ラン入力を計算します
   • test-planning-worker-runtime を開始し、委任前に child_run をチェックポイントに記録します
   • 管理されたワーカー実行を通じて ln-523-auto-test-planner を呼び出します
   • 渡すもの：ストーリー ID
   • 完了を待ちます
   • 生成された test-planning-worker アーティファクトのみを読み取ります

2. 結果を確認します：

   • 設定されたトラッカープロバイダーを通じてテストタスクが作成されていること（既存の場合は更新されていること）
   • タスク URL を ln-500 に返します

フェーズ 5：呼び出し元への報告

1. ln-500 に概要を返します：
   • 調査：完了／スキップ（既存）
   • 手動テスト：合格／失敗
   • テストタスク：作成／更新＋URL

実行時の概要アーティファクト

必ず読み込むこと： references/coordinator_summary_contract.md を読み込みます

終了前に .hex-skills/runtime-artifacts/runs/{run_id}/story-tests/{story_id}.json を書き込みます。

ワーカーの呼び出し（必須）

ホストスキルの呼び出し： Skill(skill: "...", args: "...") による委任は必須です。

• Claude：Skill ツールを表示どおりに呼び出します。
• Codex：Skill ツールがない場合は、利用可能なスキルから名前付きのスキルを見つけ、その SKILL.md を読み込み、args を $ARGUMENTS として扱って、そのスキルのワークフローを実行してから、結果／アーティファクトを持ってここに戻ります。
• ワーカーロジックをインラインで実行したり、対象スキルを実行せずにワーカーを完了扱いにしたりしないでください。

重要： すべての委任では、コンテキストを分離するために subagent_type: "general-purpose" を指定した Agent ツールを使用します。ただし、管理対象のワーカー実行はすべて、事前に test-planning-worker-runtime を通じて準備する必要があります。

フェーズ	ワーカー	目的
2	ln-521-test-researcher	実行時ランタイムに基づく管理対象 Agent 呼び出し。アーティファクトのみを完了の合図とします
3	ln-522-manual-tester	実行時ランタイムに基づく管理対象 Agent 呼び出し。アーティファクトのみを完了の合図とします
4	ln-523-auto-test-planner	実行時ランタイムに基づく管理対象 Agent 呼び出し。アーティファクトのみを完了の合図とします

プロンプトのテンプレート：

Agent(description: "[Phase N] test planning via ln-52X",
     prompt: "Execute test planning worker.

Step 1: Start worker runtime:
  node references/scripts/test-planning-worker-runtime/cli.mjs start --skill {worker} --story {storyId} --manifest-file .hex-skills/test-planning/{worker}--{storyId}_manifest.json --run-id {childRunId} --summary-artifact-path .hex-skills/runtime-artifacts/runs/{parent_run_id}/test-planning-worker/{worker}--{storyId}.json

Step 2: Checkpoint child metadata:
  node references/scripts/test-planning-runtime/cli.mjs checkpoint --story {storyId} --phase PHASE_N --payload '{\"child_run\":{\"worker\":\"{worker}\",\"run_id\":\"{childRunId}\",\"summary_artifact_path\":\".hex-skills/runtime-artifacts/runs/{parent_run_id}/test-planning-worker/{worker}--{storyId}.json\"}}'

Step 3: Invoke worker:
  Skill(skill: \"ln-52X-{worker}\", args: \"{storyId} --run-id {childRunId} --summary-artifact-path .hex-skills/runtime-artifacts/runs/{parent_run_id}/test-planning-worker/{worker}--{storyId}.json\")

CONTEXT:
Story: {storyId}",
     subagent_type: "general-purpose")

アンチパターン：

• ❌ 子ランタイムの開始と child_run のチェックポイント記録を行わずに Agent を直接呼び出す
• ❌ ウェブ検索を直接実行する（ln-521 に委任します）
• ❌ bash のテストスクリプトを直接作成する（ln-522 に委任します）
• ❌ テストタスクを直接作成する（ln-523 に委任します）
• ❌ 正当な理由なくフェーズをスキップする

TodoWrite の形式（必須）

- Resolve Story and prerequisites (pending)
- Check or reuse research state (pending)
- Start ln-521 child runtime, checkpoint metadata, or skip deterministically (pending)
- Check or reuse manual testing state (pending)
- Start ln-522 child runtime, checkpoint metadata, or skip deterministically (pending)
- Start ln-523 child runtime, checkpoint metadata, and verify test-task result (pending)
- Write story-tests summary artifact (pending)
- Report final planning outcome (pending)

重要なルール

• 直接作業の禁止： オーケストレーターは委任のみを行い、自らタスクを実行しません
• 順次実行： 521 → 522 → 523（それぞれ前のフェーズに依存します）
• フェイルファスト： 手動テストが失敗した場合は、パイプラインを停止して報告します
• スキップの検出： ワーカーを呼び出す前に既存のコメントを確認します
• 単一責任： 各ワーカーは、それぞれ 1 つのことを適切に実行します
• 管理対象のワーカー実行はすべて、Agent ラッパーがワーカーを呼び出す前に test-planning-worker-runtime を通じて開始する必要があります。

完了の定義

• ストーリー ID を検証済み
• 調査フェーズ：ln-521 を呼び出し済み、または既存のコメントを確認済み
• 手動テストフェーズ：ln-522 を呼び出し済み、または既存の結果を確認済み
• 自動テスト計画フェーズ：ln-523 を呼び出し済み
• 管理対象のワーカーを呼び出す前に、子テスト計画ランタイムを起動し、チェックポイントを記録済み
• 設定済みのトラッカープロバイダーを介してテストタスクを作成または更新済み
• 各フェーズの結果とテストタスクの URL を含むサマリーを作成済み
• ストーリーとテストのサマリー成果物を共有場所に書き込み済み

出力： 各フェーズの結果とテストタスクの URL を含むサマリー

フェーズ 6：メタ分析

任意の参照資料：ユーザーが実行後のメタ分析またはプロトコル形式の実行振り返りを求めた場合に限り、references/meta_analysis_protocol.md を読み込みます。

スキルタイプ：planning-coordinator。要求された場合は、すべてのフェーズが完了した後に実行します。planning-coordinator の形式でチャットに出力します。

参照ファイル

• ワーカー：../ln-521-test-researcher/SKILL.md、../ln-522-manual-tester/SKILL.md、../ln-523-auto-test-planner/SKILL.md
• リスクベーステスト：references/risk_based_testing_guide.md

---

バージョン： 4.0.0 最終更新日： 2026-01-15