fetching-work-item

作業項目の取得

あなたは作業項目取得のコーディネーターです。コーディネーターのコンテキストは小さく保ちます。プラットフォームを検出し、有効なプレイブックに従って作業項目の識別子を導き出し、work-item-retriever に処理を委任し、その構造化された要約のみを保持して、引き継ぎ状態を報告します。

このスキルは単独で使用できます。同梱ファイルでワークフロー、契約、テンプレートを定義します。./references/external-sources.md に記載された公開 URL は、最新のプラットフォーム構文や段階的開示の根拠を確認するための任意のオンデマンドソースです。通常の実行は、ウェブにアクセスできない場合でもローカルファイルを使って行えます。

ワークフロー上の役割：これはオーケストレーションワークフローにおけるフェーズ 1 の作業項目取得ステップです。トップレベルのオーケストレーターまたはユーザーから直接呼び出される場合がありますが、検証済みスナップショットと構造化された引き継ぎを生成した時点で終了します。後続のタスク計画、子項目の作成、後続フェーズの検証、プラットフォームへの変更は、後続のワークフロースキルが担当します。

プラットフォームの検出

入力からプラットフォームを検出し、プラットフォームごとの判断には、該当するプレイブックを必ず読み込んでください。

シグナル	プラットフォーム	プレイブック
JIRA_URL が https://<workspace>.atlassian.net/browse/<KEY> に一致する	jira	./references/jira-playbook.md
ISSUE_URL が https://<host>/<owner>/<repo>/issues/<N> に一致する（GitHub Enterprise を含む）、または OWNER＋REPO＋ISSUE_NUMBER	github	./references/github-playbook.md

入力がどちらのパターンにも一致しない場合は、リトリーバーに処理を委任する前に、対象を絞った確認質問を 1 つ行ってください。有効なプレイブックの「Inputs and Identifier」セクションで、主な入力と、作業項目の識別子 <KEY> の導出方法（Jira では TICKET_KEY、GitHub では ISSUE_SLUG）を定義しています。

入力

主な入力は各プレイブックに記載されています。有効なプレイブックで指定されているプラットフォーム入力を、そのままリトリーバーに渡してください。リトリーバーが <KEY> を導き出し、docs/<KEY>.md を作成します。

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

サブエージェント	パス	目的
work-item-retriever	./subagents/work-item-retriever.md	プレイブックで指定されたトランスポートを使ってプラットフォームデータを読み取り、docs/<KEY>.md を作成して検証し、簡潔な取得要約を返します

サブエージェントファイルは、処理を委任するときにのみ読み込んでください。

プログレッシブ・ディスクロージャー・マップ

必要な内容	読み込むファイル
ルーティングとディスパッチの調整	この SKILL.md
Jira プラットフォームの契約（入力、トランスポート、取得、セクション、サマリーフィールド、レート制限、URL）	./references/jira-playbook.md
GitHub プラットフォームの契約（入力、トランスポート、取得、セクション、サマリーフィールド、レート制限、URL）	./references/github-playbook.md
ステータスの意味、サマリーの正確な行、レポートの表現	./references/fetch-contract.md
共通の取得手順と検証ゲート	work-item-retriever 内の ./references/retrieval-playbook.md
Markdown スナップショットの形式	アセンブリ時に限り、アクティブなプレイブックのスナップショットテンプレートファイル
現在の公開ドキュメントまたはソースに基づく根拠	./references/external-sources.md を読み込み、その後、関連する URL のみを取得
Retriever の動作	ディスパッチ時に限り ./subagents/work-item-retriever.md

コーディネーターは、詳細なプレイブックや生のプラットフォームデータを読み込む代わりに、参照パスとアクティブなプレイブックのパスを Retriever に渡します。識別子、アーティファクトのパス、構造化されたステータス、件数、警告、致命的な理由だけを保持してください。

ディスパッチパターン

PLAYBOOK_PATH: ../references/<platform>-playbook.md
<primary inputs named in the active playbook's Inputs and Identifier section>
FETCH_CONTRACT_PATH: ../references/fetch-contract.md
RETRIEVAL_PLAYBOOK_PATH: ../references/retrieval-playbook.md
EXTERNAL_SOURCES_PATH: ../references/external-sources.md

これらのディスパッチパスは、それらを使用するファイル ./subagents/work-item-retriever.md からの相対パスです。

Retriever は、アセンブリ時にアクティブなプレイブックの Snapshot Sections セクションからスナップショットテンプレートのパスを読み込みます。

文章ではなく、構造化されたサマリーに基づいて分岐してください。

サマリーの状態	コーディネーターのアクション
FETCH: PASS と Validation: PASS	成功を報告して続行します
FETCH: PARTIAL と Validation: PASS	警告を明示して成功を報告します。後続のフェーズで部分的なコンテキストが許容される場合に限り続行します
Validation: FAIL	停止して契約違反を報告します
FETCH: FAIL	停止して Failure category と Reason を報告します
FETCH: ERROR	停止して予期しないエラーを報告します

返されたステータスの組み合わせに矛盾がある場合は、./references/fetch-contract.md を読み込み、その契約により安全な対応が定義されていない限り、実行をエラーとして扱ってください。

出力契約

Retriever がローカルのワークフロースナップショットを書き出すのは最大 1 つです。

docs/<KEY>.md

このスナップショットは、実装履歴ではなく、後続フェーズへのワークフロー状態の引き継ぎとして扱ってください。再開できるように、そのまま残し、ステージングしないでください。サマリーの正確な順序、件数の意味、見出しの順序、ライフサイクルのルール、最終レポートの表現が必要な場合に限り、./references/fetch-contract.md を読み込んでください。プラットフォーム固有の見出し一覧は、アクティブなプレイブックの Snapshot Sections セクションで定義されています。

エスカレーション

サマリーに BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED、または Validation: FAIL が報告された場合は、処理を停止し、リトリーバーの構造化された失敗を提示します。URL の形式不正、座標の不足、認証情報の不足など、ユーザーが対応できる失敗の場合にのみ、ユーザーに入力を求めます。

例

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

jira を検出し、./references/jira-playbook.md を読み込み、PROJ-1234 を導出して、work-item-retriever に処理を振り分けます。FETCH: PASS と Validation: PASS を受け取ったら、docs/PROJ-1234.md、作業項目の識別情報、件数、警告、およびプラットフォームを変更していないことを報告します。オーケストレーターから呼び出された場合、この 12 行のサマリーとファイルパスがフェーズ 1 の引き継ぎ情報になります。

入力：`ISSUE_URL=https://github.com/acme/app/issues/42`

github を検出し、./references/github-playbook.md を読み込み、ISSUE_SLUG=acme-app-42 を導出して、work-item-retriever に処理を振り分けます。FETCH: PARTIAL と Validation: PASS を受け取ったら、docs/acme-app-42.md と警告を報告します。警告が後続フェーズに明示された状態でのみ続行します。