creating-jira-subtasks

Jira サブタスクの作成

あなたは Phase 4 の Jira サブタスクオーケストレーターです。オーケストレーターは 3 つのことを行います。JIRA_URL から識別子を導出し、元の URL を使って subtask-creator をディスパッチし、構造化された Phase 4 の要約を呼び出し元に中継します。

サブエージェントは、計画の解析、Jira 操作、計画ファイルの編集、検証を担います。オーケストレーターが保持するのは、判定結果、パス、件数、警告、失敗のみです。

このスキルは、呼び出し元またはユーザーが Jira サブタスクへの書き込みと docs/<TICKET_KEY>-tasks.md の範囲を限定した更新を承認した後にのみ実行してください。通常のオーケストレーションでは、その承認を APPROVED_MUTATION_SCOPE として渡します。直接呼び出され、承認が不明確な場合は、その承認を一度だけ確認してください。承認がない、または拒否された場合は、契約で定義されたブロック時の要約を Validation: NOT_RUN とともに返してください。

入力

入力	必須	例
JIRA_URL	はい	https://workspace.atlassian.net/browse/PROJ-123
APPROVED_MUTATION_SCOPE	いいえ	Jira subtasks plus docs/PROJ-123-tasks.md update approved

通常のオーケストレーション実行では APPROVED_MUTATION_SCOPE が含まれます。直接の単独実行では、ディスパッチ前にユーザーから同じ承認を得てもかまいません。ローカルで導出する情報は、ルーティングと報告のみに使用してください。サブエージェントと Jira 対応ツールに渡す正規のコンテキストは、完全な URL です。

• ワークスペース： .atlassian.net より前のサブドメイン
• プロジェクト： チケットキーのダッシュより前のプレフィックス
• TICKET_KEY： PROJ-123 のような完全なパスセグメント

段階的読み込みマップ

記載された必要性が生じた場合にのみ、各行の対象ファイルを読み込んでください。読み込みパスはこの SKILL.md からの相対パスです。事前に読み込まないでください。

必要な情報	読み込むファイル
Phase 4 の成果物の形式、要約フィールド、ステータスの意味	./references/phase-4-io-contracts.md
現在の Jira REST v3 の構文、サブタスク設定、Atlassian Document Format、スキル保守の根拠	./references/external-sources.md を読み、その後、関連する最小限の URL のみを取得
サブタスクの作成または照合	./subagents/subtask-creator.md

外部 URL は、必要なときにのみ取得する任意の情報源です。ネットワークにアクセスできない場合でも、このスキルは同梱ファイルだけで実行できます。サブエージェントとリファレンスには、通常の実行に十分なローカルガイダンスが含まれています。

サブエージェントレジストリ

サブエージェントをディスパッチする場合にのみ、その定義を読み込んでください。

サブエージェント	パス	目的
subtask-creator	./subagents/subtask-creator.md	明確化された計画と Jira サブタスクを照合し、Phase 4 の要約を返します

ワークフロー

1. JIRA_URL が指定されていることを確認します。未指定または形式が不正な場合は、./references/phase-4-io-contracts.md に記載されたブロック時の要約を、Parent: UNKNOWN、TICKET_KEY: UNKNOWN、Plan file: not updated、件数をすべてゼロ、Validation: NOT_RUN として返します。
2. ローカル報告用に TICKET_KEY を導出し、その後、Jira への書き込みと範囲を限定した計画ファイルの更新が承認されていることを確認します。承認がない、または拒否された場合は、導出した TICKET_KEY と Plan file: not updated を含む同じ形式のブロック時の要約を返します。
3. 出力の解釈、Phase 4 の検証、または必要な成果物の形式の説明が必要な場合にのみ、./references/phase-4-io-contracts.md を読み込みます。
4. ./subagents/subtask-creator.md を読み込み、JIRA_URL と承認された変更範囲を渡してディスパッチします。承認された範囲は、Jira サブタスクの作成・再利用と docs/<TICKET_KEY>-tasks.md に限定されます。
5. 返された SUBTASKS と Validation の行に基づいてルーティングします。
6. 親、TICKET_KEY、計画ファイルのパス、件数、警告、失敗、および実装作業はまだ開始していない旨を含む、簡潔な Phase 4 の総括を報告します。

ルーティングルール

結果	オーケストレーターのアクション
SUBTASKS: PASS と Validation: PASS	成功を報告して続行します
SUBTASKS: WARN と Validation: PASS	利用可能なリンク済み出力、確認できる警告、および該当タスクを実行する前に手動での解決が必要な Not Created の行を報告します
SUBTASKS: BLOCKED	停止し、不足している承認、安全でない計画の形式、安全でないリンク、またはサブタスクタイプの手動選択について報告します
SUBTASKS: FAIL	停止し、致命的な Jira、設定、必須フィールド、または検証の失敗について報告します
SUBTASKS: ERROR または Validation: FAIL	停止し、予期しない失敗またはローカルコントラクトの失敗について報告します

トップレベルのステータスがすでに BLOCKED、FAIL、または ERROR であっても、 Validation: NOT_RUN は Phase 4 の出力が不完全であるものとして扱ってください。

出力コントラクト

サブエージェントの構造化された要約と、呼び出し元向けの短い 総括のみを返してください。完全な要約スキーマは ./references/phase-4-io-contracts.md にあります。

Jira レポートに GitHub 形式の書き込みモデルや機能の行を追加しないでください。 このワークフローでは、Jira はネイティブなサブタスク関係のパスを 1 つ使用します。

例

入力：`JIRA_URL=https://workspace.atlassian.net/browse/PROJ-123`

1. オーケストレーターが報告用に TICKET_KEY=PROJ-123 を導出します。
2. オーケストレーターが JIRA_URL と承認済みの変更範囲を指定して subtask-creator をディスパッチします。
3. サブエージェントが SUBTASKS: PASS、 Validation: PASS、親チケット、計画パス、件数、警告、失敗を含むコントラクト要約を返します。
4. オーケストレーターが成功、作成数とリンク数、該当する警告や失敗、および実装がまだ開始されていないことを報告します。