rhdh-jira-create

RHDH Jira 作業の作成

「これはチケットにするべきです」という依頼に対応するスキルです。課題タイプとプロジェクトを判断し、ヒアリングを行い、RHDH テンプレートに基づいて下書きを作成して、課題を作成します。

「これを Jira に登録して」と依頼するユーザーは、Feature、Epic、Story のどれにするべきかをほとんど把握していません。それを判断するのがこのスキルの役割です。判断を誤ると、公開プロジェクトに誤った課題タイプを書き込むことになります。そのため、最初に判断内容を明示し、作成前にユーザーに確認してもらいます。

ルート

workflows/create-issue.md を読み込みます。すべての階層レベルを単一のワークフローで扱います。最初の実質的な手順でタイプを判断し、その後の手順は合流します。

サポートケースが発端となる作業の場合は、references/support-intake.md を追加します。対象となるのは、RHDHSUPP での会話、顧客からのエスカレーション、SLA に関する質問、またはケースを不具合や機能要望に変換する依頼です。

ヒアリングは必須条件です

作成には、外部の grilling スキルが必要です。このスキルパックには含まれていません。ホストが名前で呼び出せない場合は、何も作成せずに停止し、作成には grilling が必須であることと、/setup-rhdh-skills install を案内してください。ホストのスキルディレクトリを調べたり、自分でインストールしたり、代わりのヒアリングを即興で行ったりしてはいけません。

/rhdh-jira-authoring は、課題の掘り下げマトリックス、フィールドの推定、サイズ見積もり、テンプレートなど、ヒアリングの RHDH 側を担います。名前で呼び出してください。

作成はすべて外部への書き込みです

課題を作成、リンク、コメント、編集する acli コマンドを実行する前に /mutation-gate を呼び出し、その手順に従ってください。作成が 1 回の操作だけで済むことはほとんどありません。作成、作成時に設定できなかったフィールドの更新、親課題へのリンク、コメントを、明示する操作セットにまとめ、1 回の承認ですべてをカバーします。

その後、課題を読み戻してください。作成に成功しても、フィールド更新が気付かれないまま失敗した場合、それは作成の成功ではなく、未完成の課題です。

非公開課題は「作成後に設定」するものではありません。 公開プロジェクト（RHIDP、RHDHPLAN、RHDHBUGS）では、作成ペイロードに security を指定してください（/rhdh-jira-api — Private issues）。RHDHSUPP はプロジェクトが非公開のため、レベルの指定は任意です。作成後に制限をかけてはいけません。必要なときに security を設定できない場合は、停止してください。

隣接するスキルとの境界

• 既存の課題の準備状況を判断するには、/rhdh-jira-refine を使います。
• 既知のキーのステータス、担当者、コメント、リンクを変更するには、/rhdh-jira-update を使います。
• acli の構文、フィールド ID、コンポーネントカタログ、ワークフローの終了基準については、/rhdh-jira-api を使います。
• テンプレート、課題の掘り下げマトリックス、サイズ見積もり、重複検出、分割ルールについては、/rhdh-jira-authoring を使います。
• PR を作成して課題にリンクするには、/rhdh-jira-link を使います。

完了

作成前にユーザーが課題タイプを確認し、重複チェックを実行して結果を報告し、ヒアリングを行い、作成したすべてのキーについて読み戻しを行い、結果のステータス、親課題へのリンク、実際に設定されたフィールドを報告した時点で完了です。API が拒否したフィールドは、設定済みではなく未設定として報告してください。分割作業が完了するのは、子課題を作成する前にユーザーがバッチ表を承認し、その表に記載されたすべての子課題にキーが付与されるか、スキップした理由が明示された場合に限ります。