rhdh-jira-api

RHDH Jira API

Jira とやり取りするための一元的な場所です。コマンド構文、フィールド ID、クエリパターン、ワークフロールールをここにまとめているため、作成、調整、更新、スプリントの各スキルが独自の内容を持つ必要はありません。

このスキルは読み取りを行います。何を起票するかを判断することも、書き込みを承認することもありません。ただし、書き込みのペイロード形式がここにあるため、書き込みに必要な内容は正確に定義します。

質問に応じて参照先を選ぶ

質問	参照先
Jira に接続できますか？acli は認証済みですか？	references/auth.md、次に uv run scripts/setup.py --json
どの acli フラグを使えばよいですか？何が問題になりますか？	references/acli-commands.md
この質問に答える JQL はどれですか？どのボードまたはスプリントですか？	references/jql-patterns.md
カスタムフィールド、ラベル、リンクタイプ、コンポーネント、優先度はどれですか？	references/fields.md
非公開（セキュリティレベル）課題を作成または検索するにはどうすればよいですか？	references/fields.md（非公開課題。あわせて jql-patterns / acli-commands も参照）
このステータス遷移の前に、何が満たされている必要がありますか？	references/workflows.md
関連情報を多く含む一括読み取り、またはチーム名簿が必要です	references/graphql-queries.md
acli でこのフィールドを読み取れない、または設定できません	references/rest-api-fallback.md
スプリントレポートまたはバーンダウンチャートの数値	references/rest-api-fallback.md、次に uv run scripts/greenhopper.py

質問に必要な項目だけを参照してください。

誤った回答につながる 2 つの落とし穴

どちらも警告なしに失敗し、このパックでも過去に問題になりました。

デフォルトのページサイズは 30 です。 31 件目以降の行は警告なしに切り捨てられるため、本来 140 件の課題を返すクエリでも、気付かないうちに 30 件だけが返され、それを基にした件数はすべて誤りになります。一括検索では毎回 --limit 500 または --paginate を指定し、合計件数が重要な場合は先に --count を使用してください。

カスタムフィールドは、指定しない限り取得されません。 search --json と view KEY --json が返すのは、担当者、課題タイプ、優先度、ステータス、要約のみです。ストーリーポイント、チーム、サイズ、スプリントは空として返されます。これは、まるで誰もフィールドを設定していないかのように見えます。いずれかが欠落していると判断する前に、scripts/parse_issues.py --enrich または view KEY --fields '*all' --json で詳細を取得してください。

取得できなかったフィールドは、空ではなく未取得として報告します。

同梱スクリプト

このスキルのディレクトリから実行してください。

スクリプト	目的
scripts/setup.py	機能と認証の検出。--json はファイル内容を表示せずに token_file_found / token_file_status を報告します
scripts/parse_issues.py	acli の JSON を詳細化、フラット化、選択、フィルタリング、または CSV にエクスポートします
scripts/greenhopper.py	ローカルトークンファイルをプロセス内で使用して、Greenhopper の sprintreport / scopechange を GET します
scripts/validate_components.py	ドキュメント化されたコンポーネントカタログを Jira の実データと照合します
scripts/jira-wiki-to-adf.py	入力済みの wiki-markup テンプレートを ADF JSON に変換します

標準ライブラリのみを使用します。別のスキルが /rhdh-jira-api を名前で呼び出し、このスキルにスクリプトを実行させます。このディレクトリをパスで直接参照することはありません。

書き込み

このスキルは書き込みを実行しませんが、フィールド ID がここにあるため、ペイロードもここに置いています。呼び出し元に渡すのはコマンドまたはペイロードであり、実行結果ではありません。操作を担当するスキルが /mutation-gate を呼び出し、そこから実行します。

認証情報が引数、プレビュー、ログ、回答に現れることはありません。ここで組み立てるコマンドは、実行時に acli 独自のストア、ローカルトークンファイルアダプター（プロセス内で使用し、表示しません）、または認証済みホストアダプターから認証情報を取得するため、このスキルが返す内容に認証情報が含まれることはありません。

隣接するスキルとの境界

• 新しい作業の開始には /rhdh-jira-create を使用します。
• 既存の作業が着手可能かどうかの判断には /rhdh-jira-refine を使用します。
• 既知のキーのフィールド、ステータス、担当者、コメント、またはリンクの変更には /rhdh-jira-update を使用します。
• スプリントへの持ち越し、ベロシティ、次のスプリントのキャパシティには /rhdh-jira-sprint-plan を使用します。スプリント終了時の概要には /rhdh-jira-sprint-report を使用します。
• チームが Code Freeze までに rhdh-X.Y-candidate の Feature をどれだけ対応できるかの判断には /rhdh-release-capacity-plan を使用します。
• 課題テンプレート、グリルマトリクス、見積もりスケール、分解ルールには /rhdh-jira-authoring を使用します。
• リリースに対してまだオープンな項目の確認には /rhdh-release-status を使用します。
• 認証情報の作成または修復には /setup-rhdh-skills を使用します。

完了

回答で言及するすべてのフィールドを実際に取得した時点で、読み取りは完了です。 使用した正確な JQL またはコマンド、返された課題の件数、結果が切り詰められていたかどうかを報告してください。結果が切り詰められている場合、それは不完全な回答であり、調査結果ではありません。各情報の取得元アダプターが acli かホストアダプターかを明記してください。API から取得できなかったフィールドは、空欄または以前のクエリの結果として報告せず、未取得として明記してください。