executing-jira-task

Jira タスクの実行

Jira ワークフローにおけるタスクごとの実行オーケストレーターです。次の3つを行います。準備状況を検証し、次のスペシャリストに引き継ぎ、続行するか、対象を絞った修正サイクルを実施するか、エスカレーションするかを判断します。スペシャリストが個別に主要な作業を行い、オーケストレーターは各フェーズ間で簡潔な要約、パス、判定のみを引き継ぎます。

実行の開始は、レビュー承認後に初めて変更を加える境界です。開始前は、すべての内容がディスク上のレビューと計画のままです。

入力

入力	必須	例	備考
TICKET_KEY	はい	JNS-6065	成果物と Jira のパスを導出するために使用します。
TASK_NUMBER	はい	3	呼び出しごとにタスクを1つだけ指定します。

必須の成果物、準備状況の確認項目、引き継ぎ形式、開始時の動作、成果物のライフサイクルルールは ./references/contracts.md に記載されています。実行の境界を越える前に、このファイルを読んでください。

ワークフローの概要

段階	目標	主な結果
0. 準備状況	選択したタスクを開始できることを確認する	準備完了タスクまたは明示的なブロッカー
1. 開始	計画済みのブランチに入り、トラッカーの状態を開始する	KICKOFF_REPORT
2. 実行	承認された変更を実装する	EXECUTION_REPORT
3. ドキュメント作成	コード内ドキュメントを追加し、ゲートの前にローカルの追跡情報を更新する	DOCUMENTATION_REPORT
4. 要件検証	Definition of Done の対象範囲を確認する	VERIFICATION_RESULT
5. 品質ゲート	クリーンコード、アーキテクチャ、セキュリティのレビューを実施する	レビュー判定
6. 対象を絞った修正サイクル	明示的な再試行回数の上限を設け、検証またはレビューで失敗したパスのみを再実行する	再検証済みタスクまたはエスカレーション
7. 最終処理と報告	ゲート通過後に条件を満たす Jira の完了処理を行い、このタスクの結果を報告する	FINAL_TRACKING_REPORT および FINAL_TASK_REPORT

サブエージェント一覧

サブエージェント	パス	目的
execution-starter	./subagents/execution-starter.md	開始処理、ワークスペースの確認、ブランチへの移行、条件を満たす Jira の開始時更新を行います。
task-executor	./subagents/task-executor.md	承認済みの計画成果物に基づいて、対象範囲内の変更とテストを実装します。
documentation-writer	./subagents/documentation-writer.md	必要最小限のコード内ドキュメントを追加し、タスクの追跡情報を更新して、ゲート通過後に任意の Jira 完了更新を行います。
requirements-verifier	./subagents/requirements-verifier.md	品質レビューの前に、タスクの DoD がすべて実装されていることを確認します。
clean-code-reviewer	./subagents/clean-code-reviewer.md	可読性、保守性、SOLID への準拠、テストの品質をレビューします。
architecture-reviewer	./subagents/architecture-reviewer.md	ドメインの境界、構成、アーキテクチャへの適合性をレビューします。
security-auditor	./subagents/security-auditor.md	タスクの対象範囲に含まれる変更セットを調査し、悪用可能なセキュリティ上の弱点を確認します。

引き継ぎごとにサブエージェントの定義を1つだけ読み、そのサブエージェントに必要な入力のみを渡してください。

このスキルの仕組み

このパッケージは単独で動作します。実行時に重要なルールは、このスキルのフォルダーに含まれています。外部 URL は必要に応じて参照できる補足情報であり、通常の実行には不要です。

段階的に情報を開示します。

1. このファイルをルーティング層として使用します。
2. 現在のフェーズで必要な場合に限り、参照ファイルを1つ読みます。
3. スペシャリストへの引き継ぎ時に限り、サブエージェントファイルを1つ読みます。
4. サブエージェントには、出力を返す際にのみレポートテンプレートを読み込ませます。
5. 判断に必要な場合を除き、生のファイル内容、コマンドログ、API レスポンスをオーケストレーターのコンテキストに含めないでください。

段階的な読み込みマップ

必要な情報	参照先
成果物の契約と準備状況の確認	./references/contracts.md
通常の実行フローと修正ループの順序	./references/pipeline.md
ステータスの処理、再試行、エスカレーション	./references/retry-and-escalation.md
レビュアー共通の期待事項	./references/review-gate-policy.md
現在の状況や根拠に基づく情報を得るための任意のウェブサイトリンク	./references/external-sources.md
ディスパッチと対象を絞った修正の例	./references/examples.md
最終ユーザーレポートのテンプレート	./references/template-final-report.md

サブエージェントのレポートテンプレートは、対応するサブエージェントが返却時にのみ読み込みます。

サブエージェント	返却テンプレート
execution-starter	./references/template-execution-kickoff-report.md
task-executor	./references/template-execution-report.md
documentation-writer	./references/template-documentation-report.md
requirements-verifier	./references/template-requirements-verification.md
clean-code-reviewer	./references/template-code-quality-review.md
architecture-reviewer	./references/template-architecture-review.md
security-auditor	./references/template-security-audit.md

documentation-writer が FINALIZE_TRACKER モードで実行される場合は、 ./references/template-documentation-report.md を使用し、そのレポートを FINAL_TRACKING_REPORT として返します。

実行手順

1. ./references/contracts.md を読み、選択したタスクが実行に進める状態であることを確認します。
2. ./references/pipeline.md を読み、そのフェーズ順に従います。
3. 次に必要なサブエージェントのみを、明示的な入力とともにディスパッチします。
4. オーケストレーションのコンテキストには、構造化された要約のみを保持します。
5. ブロッカー、前提条件の不足、またはゲートの不合格がある場合は、復旧に関するリファレンスを読み、新しいコンテキスト、修正概要、または明示的なユーザー判断がある場合に限り、再試行予算の範囲内で再試行します。
6. 選択したタスクが完了した場合、ブロックされた場合、ユーザー入力が必要な場合、またはエスカレーションされた場合は停止し、自動的に続行しないでください。

出力契約

各実行の最後には、./references/template-final-report.md を使用した FINAL_TASK_REPORT を必ず 1 件だけ出力します。許可される最終ステータスは COMPLETE、 BLOCKED、STOPPED_FOR_USER_INPUT、ESCALATED です。

COMPLETE の場合、このワークフローではカテゴリ B の実装変更を行い、カテゴリ A の追跡成果物をディスク上で更新し、対象となる Jira の開始時更新またはスキップを記録します。また、要件と品質ゲートに合格した後に限り、対象となる Jira の完了時更新を確定し、親オーケストレーターが求める品質ゲートの要約と実装成果物の要約を含めます。

停止またはエスカレーションされた実行でも、ブロッカー、再試行回数、保持されたフェーズ結果、未解決項目、次に必要なアクションを含む FINAL_TASK_REPORT を返します。

運用上の制約

• 1 回の実行につき、タスクは 1 件だけ実行します。
• タスク計画と決定ファイルを信頼できる情報源として扱います。
• カテゴリ A のオーケストレーション成果物はディスク上に保持し、Git の履歴には含めません。
• 修正サイクルの対象は絞り込みます。不合格となった検証またはレビューステップのみを再実行し、要件と各品質ゲートの試行回数はそれぞれ最大 3 回とします。
• 停止したステップの再試行は、新しいコンテキスト、修正概要、または明示的なユーザー判断によって入力が変更された場合に限ります。
• 要件検証とすべての品質ゲートに合格するまで、Jira の最終的な完了状態への遷移やコメントは保留します。
• スキルの不足、追跡機能の不足、安全でないワークスペースの状態、または未解決の曖昧さを明確に示し、停止します。

例

入力：TICKET_KEY=JNS-6065、TASK_NUMBER=3

1. ./references/contracts.md を使用して、必要な成果物を検証します。
2. execution-starter をディスパッチし、KICKOFF_REPORT -> READY の場合に限り続行します。
3. ./references/pipeline.md の順序に従って、実装、ドキュメント作成、検証、レビュ―ゲート、最終的な追跡情報の完了処理をディスパッチします。
4. ./references/template-final-report.md を使用し、タスク 3 のみを FINAL_TASK_REPORT として報告します。