mcpField
P
planning-jira-tasks

planning-jira-tasks

github.com/b-mendoza開発355 回インストール3 日前に更新
リポジトリ

planning-jira-tasks について

Jiraチケットのスナップショットをタスクファイルに計画する、第2フェーズのオーケストレーターです。段階的な計画と検証で専門エージェントを振り分け、再試行や再計画用に成果物を保持します。

主な機能

  1. 01既存のJiraスナップショットから計画
  2. 02専門計画エージェントの振り分け
  3. 03各計画段階の検証
  4. 04再開・批評用の成果物を保持
  5. 05失敗した段階のみ再試行

活用シーン

  1. 01Jiraチケットをタスクに分解
  2. 02批評や決定変更後の再計画
  3. 03未完了の計画作業の再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/b-mendoza/agent-skills --skill planning-jira-tasks

インストール後、Claude Code で/planning-jira-tasksを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

flow-diagram.md
references/
dependency-and-branch-guide.md
dependency-prioritizer-template.md
execution-guide.md
external-sources.md
output-contract.md
re-plan-cycle.md
task-planner-template.md
task-planning-guide.md
validation-checks.md
subagents/
dependency-prioritizer.md
stage-validator.md
task-planner.md
task-validator.md

詳細

Jira チケットタスクの計画

Jira チケットのスナップショットを docs/<TICKET_KEY>-tasks.md にまとめます。これは Jira 計画ワークフローの Phase 2 オーケストレーターです。各ステージを振り分け、専門エージェントに作業を委任し、再開や批評に備えてステージの成果物を保持し、簡潔な引き継ぎを返します。

オーケストレーターがコンテキスト内に保持するのは、ワークフローの状態、サブエージェントの判定、パス、件数、ユーザーの判断のみです。詳細な仕様、テンプレート、検証チェック、ソースに基づく背景情報は、バンドルされたリファレンスまたは任意の外部 URL から必要なときに読み込みます。

入力

入力必須例
TICKET_KEYはいJNS-6065
RE_PLANいいえtrue
DECISIONSいいえSSO decision changes task dependencies

Phase 2 はファイル駆動です。Jira チケットのスナップショット docs/<TICKET_KEY>.md がすでに存在している必要があります。

段階的な読み込みマップ

必要な内容読み込むファイル
通常の実行、委任ペイロード、再試行ループ./references/execution-guide.md
最終成果物の仕様、ブランチポリシー、サブタスクの扱い./references/output-contract.md
批評に基づく再計画、またはステージ成果物からの復旧./references/re-plan-cycle.md
ソースに基づく背景情報、または現行プラットフォームの構文./references/external-sources.md
サブエージェント固有のガイド、テンプレート、検証チェック委任先のサブエージェントからのみ読み込む

このファイル内のバンドル済みパスは、この SKILL.md からの相対パスです。後から読み込むファイルでは、それぞれの場所からの相対パスを使用します。すべてのバンドル済みファイルはパッケージに含まれています。 外部 URL は任意の段階的な拡張です。ローカルの仕様に背景情報や現行の構文が必要な場合に限って取得し、ネットワークにアクセスできない場合はバンドル済みのリファレンスに基づいて進めます。

サブエージェント一覧

サブエージェントパス目的
task-planner./subagents/task-planner.mdチケットを分解し、ステージ 1 の計画案を作成する
dependency-prioritizer./subagents/dependency-prioritizer.md依存関係の順序、優先度、ブランチ名を追加する
task-validator./subagents/task-validator.md優先順位付けされた計画を検証し、QA の指摘事項を追記する
stage-validator./subagents/stage-validator.md事前確認、ステージ間、最終の構造ゲートをチェックする

ワークフロー

経路条件次に読むリファレンス
通常RE_PLAN が未設定または false./references/execution-guide.md
再計画RE_PLAN=true かつ批評に関する判断がある./references/re-plan-cycle.md、続けて ./references/execution-guide.md

通常の経路は、事前確認でのスナップショット検証、詳細計画のステージ 1、ステージ 1 の検証、依存関係とブランチ計画のステージ 2、ステージ 2 の検証、最終検証レポートのステージ 3、ステージ 3 の検証、パイプライン後検証、引き継ぎの順です。

docs/<TICKET_KEY>-stage-1-detailed.md、 docs/<TICKET_KEY>-stage-2-prioritized.md、および docs/<TICKET_KEY>-tasks.md をディスク上に保持してください。これらは再開、批評、対象を絞った再試行のためのオーケストレーション状態であり、実装成果物ではありません。

対象を絞った修正ループのみを使用してください。不合格となった成果物を作成したステージを再度実行し、バリデーターの指摘事項リストのみを渡し、不合格となったゲートのみを再実行します。同じゲートで 3 回失敗したら停止してください。

返却形式

このフェーズの引き継ぎのみを返します。すべてのステージとステージ検証ゲートに合格した場合に限り、PLANNING: PASS を使用してください。

PLANNING: PASS | FAIL
TICKET_KEY: <TICKET_KEY>
File: <final file path or "not written">
Tasks: <N>
Branches: <N unique branch names>
Cross-cutting questions: <N>
Validation warnings: <N>
Failure category: PREFLIGHT | STAGE_1 | STAGE_2 | STAGE_3 | POSTPIPELINE | NONE
Reason: <one line>
Artifacts preserved: <comma-separated paths>

例

入力：`TICKET_KEY=JNS-6065`
  1. 委任ペイロードを確認するため、./references/execution-guide.md を読み込みます。
  2. stage-validator を preflight 用に実行し、STAGE_VALIDATION: PASS が返されます。
  3. task-planner、dependency-prioritizer、task-validator を順に実行し、成果物が作成されるたびに検証します。
  4. stage-validator を postpipeline 用に実行し、STAGE_VALIDATION: PASS が返されます。
  5. 成果物のパスを保持した簡潔な PLANNING: PASS の引き継ぎを返します。

コメント

Markdown 対応