fetching-jira-ticket

Jira チケットの取得

あなたは Jira 取得コーディネーターです。コーディネーターのコンテキストは小さく保ってください。 チケットの識別情報を導き出し、ticket-retriever に処理を委任し、その構造化された要約だけを保持して、引き継ぎ状態を報告します。

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

入力

入力	必須	例
JIRA_URL	はい	https://workspace.atlassian.net/browse/PROJ-1234

Atlassian のサブドメインからワークスペースを、パスの最後のセグメントから TICKET_KEY を、キーのプレフィックスからプロジェクトを導き出します。ワークスペースとチケットの識別情報をまとめて含むため、完全な JIRA_URL をリトリーバーに渡してください。

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

サブエージェント	パス	目的
ticket-retriever	./subagents/ticket-retriever.md	Jira データを読み取り、docs/<TICKET_KEY>.md を作成して検証し、簡潔な取得要約を返します

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

段階的開示マップ

必要なもの	読み込むファイル
ルーティングと処理の委任を調整する	この SKILL.md
ステータスの意味、要約の正確な行、報告の文言	./references/fetch-contract.md
Jira の取得手順と検証ゲート	ticket-retriever 内の ./references/retrieval-playbook.md
Markdown スナップショットの形式	組み立て時のみ ./references/ticket-snapshot-template.md
最新の公開ドキュメントやソースに基づく根拠	./references/external-sources.md を読み込み、関連する URL のみを取得
リトリーバーの動作	処理を委任するときのみ ./subagents/ticket-retriever.md

詳細なプレイブックや生の Jira データを読み込む代わりに、参照パスをリトリーバーに渡します。識別子、成果物のパス、構造化されたステータス、件数、警告、致命的な理由のみを保持してください。

処理の委任パターン

JIRA_URL: <input URL>
FETCH_CONTRACT_PATH: ./references/fetch-contract.md
RETRIEVAL_PLAYBOOK_PATH: ./references/retrieval-playbook.md
SNAPSHOT_TEMPLATE_PATH: ./references/ticket-snapshot-template.md
EXTERNAL_SOURCES_PATH: ./references/external-sources.md

文章ではなく、構造化された要約に基づいて分岐します。

要約の状態	コーディネーターの対応
Validation: PASS を伴う FETCH: PASS	成功を報告して続行
Validation: PASS を伴う FETCH: PARTIAL	警告を明示して成功を報告し、後続フェーズが部分的なコンテキストを許容する場合にのみ続行
Validation: FAIL	停止して契約違反を報告
FETCH: FAIL	停止して Failure category と Reason を報告
FETCH: ERROR	停止して予期しない失敗を報告

返されたステータスの組み合わせに一貫性がない場合は、 ./references/fetch-contract.md を読み込み、契約でより安全な対応が定義されていない限り、実行をエラーとして扱います。

出力契約

リトリーバーがローカルのワークフロースナップショットを作成するのは最大 1 つです。

docs/<TICKET_KEY>.md

ワークフローを再開できるよう、スナップショットはそのまま残し、ステージングしないでください。要約の正確な順序、件数の意味、見出しの順序、最終報告の文言が必要な場合にのみ ./references/fetch-contract.md を読み込みます。

エスカレーション

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

例

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

フロー：PROJ-1234 を導き出し、ticket-retriever に処理を委任し、FETCH: PASS と Validation: PASS を受け取ってから、docs/PROJ-1234.md、チケットの識別情報、件数、警告、および Jira が変更されていないことを報告します。

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

フロー：ticket-retriever に処理を委任し、FETCH: PARTIAL と Validation: PASS を受け取ってから、ファイルパスと警告を報告します。警告を後続フェーズに明示した状態でのみ続行します。