jira-ticket-viewer

Jira チケットビューアー

jira CLI ツールを使用して、Jira チケットの詳細を取得して表示します。

入力

生の引数：$ARGUMENTS

引数から次の値を推定します：

• TICKET_KEY：Jira 課題キー
• OUT_DIR：出力ディレクトリ。指定がない場合は .implement-assets/jira

システム要件

• jira CLI がインストールされ、設定されていること（https://github.com/ankitpokhrel/jira-cli）
• 環境変数 JIRA_API_TOKEN に有効な Jira API トークンが設定されていること。重要： この変数を確認する際は、未設定と判断する前に少なくとも 2 回確認してください。シェルのコンテキストの違いにより、環境変数が未設定に見えることがあります。値を絶対に公開しないでください — 存在確認のみを使用してください（例：test -n "$JIRA_API_TOKEN"）。
• 環境変数 JIRA_SERVER に Jira のベース URL が設定されていること（例：https://yourcompany.atlassian.net）。

実行

1. 事前確認：jira me を実行して、CLI がインストールされ、認証されていることを確認します。失敗した場合は、references/rules.md のエラー処理に従ってください。jira me が成功するまで続行しないでください。
2. TICKET_KEY を references/rules.md に従って検証します。
3. 生の JSON を取得（API 呼び出しは 1 回）：Bash 経由で mkdir -p OUT_DIR && jira issue view TICKET_KEY --raw > OUT_DIR/raw.json を実行します。
4. チケットを解析：Bash 経由で node ${CLAUDE_SKILL_DIR}/scripts/parse-ticket.js < OUT_DIR/raw.json > OUT_DIR/dossier.json を実行して、解析済みの JSON 出力を取得します。
5. プルリクエストを取得：Bash 経由で node ${CLAUDE_SKILL_DIR}/scripts/fetch-pull-requests.js < OUT_DIR/raw.json > OUT_DIR/pull-requests.json を実行します。出力が空でない配列の場合は、OUT_DIR/dossier.json を読み込み、その配列を含む pullRequests フィールドを追加し、Write ツールで保存します。PR の取得失敗は致命的ではありません。警告を出して続行してください。
6. コメントを解釈：解析済み JSON に空でない comments 配列が含まれている場合は、references/comment-rules.md に従って分析します。JSON の comments 配列を commentSummary オブジェクトに置き換え、更新した JSON を Write ツールで OUT_DIR/dossier.json に保存します。
7. 添付ファイル：解析済み JSON に空でない attachments 配列が含まれている場合は、ダウンロードします：
   • Bash 経由で node ${CLAUDE_SKILL_DIR}/scripts/download-attachment.js --out OUT_DIR < OUT_DIR/raw.json を実行します。
   • ダウンロードした添付ファイルのパスを出力に含めます。
8. 解析済みの JSON 出力を返します（スキーマの参考情報は references/output-format.md を参照）。添付ファイルをダウンロードした場合は、そのパスも含めます。