rhdh-jira-authoring について
rhdh-jira-authoring は、Jira 課題の作成とレビューに使う RHDH 固有のガイドを提供するスキルです。テンプレート、フィールド推定、見積もり、重複確認、作業分解を扱い、Jira コマンドの実行や書き込みは行いません。
主な機能
- 01RHDH 課題テンプレートと例
- 02草稿への問いかけとフィールド推定
- 03課題サイズの見積もりガイド
- 04重複確認のガイド
- 05Feature と Epic の分解
活用シーン
- 01RHDH Jira 課題の起草
- 02草稿の情報不足を確認
- 03定義済み尺度で課題を見積もり
- 04Feature や Epic を小さな作業に分割
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-jira-authoringインストール後、Claude Code で/rhdh-jira-authoringを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlassets/examples/bug-example.txtepic-example.txtfeature-example.txtstory-example.txttask-example.txtassets/templates/bug.txtepic.txtfeature.txtstory.txttask.txtreferences/duplicates.mdgrill.mdsizing.mdwork-breakdown.md詳細
RHDH Jira 作成
6 か月後にその課題を読む価値があるかどうかを決める資料です。
ドラフト作成時には /rhdh-jira-create、監査時には /rhdh-jira-refine の 2 つのスキルがこの資料を使うため、どちらにも含めず、ここに置いています。
このスキルが作成するのはテキストと判断です。Jira コマンドの実行や書き込みは一切行いません。
ニーズに応じた参照先
| ニーズ | 読み込むもの |
|---|---|
| ドラフトへの問いかけ方、会話から RHDH Jira のフィールドを推測する方法 | references/grill.md |
| T シャツサイズ、ストーリーポイント、RHDHSUPP の工数ポイント、サイズに関する問いかけ | references/sizing.md |
| これはすでに存在しますか? | references/duplicates.md |
| Feature を Epic に、Epic を Story に分割する方法 | references/work-breakdown.md |
テンプレートと例
説明テンプレートは Jira Wiki マークアップです。それぞれのテンプレートには、文体と詳細度を調整するための記入例が用意されています。テンプレートだけでは RHDH のレビュアーが期待する詳細度が十分に示されないため、ドラフトを作成する前に例を読んでください。
| 課題タイプ | 通常のプロジェクト | テンプレート | 例 |
|---|---|---|---|
| Feature | RHDHPLAN | assets/templates/feature.txt | assets/examples/feature-example.txt |
| Epic | RHIDP | assets/templates/epic.txt | assets/examples/epic-example.txt |
| Story | RHIDP | assets/templates/story.txt | assets/examples/story-example.txt |
| Task | RHIDP | assets/templates/task.txt | assets/examples/task-example.txt |
| Bug | RHDHBUGS | assets/templates/bug.txt | assets/examples/bug-example.txt |
Spike には Task テンプレートを使用し、サマリーに SPIKE: のプレフィックスを付け、時間を区切ったストーリーポイント見積もりを記載します。Vulnerability には Story テンプレートを使用し、必ず Security コンポーネントを設定します。Feature Request と Outcome のテンプレートは RHDHPLAN にありますが、このスキルには含まれていないため、Jira UI でそのプロジェクト独自のテンプレートを使ってドラフトを作成してください。
サブタスクは既存の課題の子であり、単独の課題にはなりません。
記入済みのテンプレートは Wiki マークアップです。Wiki マークアップを ADF テキストノードに変換せずそのまま埋め込むと、Jira Cloud では Wiki マークアップや Markdown がリテラル文字(h1.、*text*、# Heading)として表示されます。Wiki から ADF への変換は /rhdh-jira-api が担当します。Markdown の段落から ADF を手作業で組み立てないでください。
隣接するスキルとの境界
- インタビューを実施して課題を作成するのは
/rhdh-jira-createです。 - 既存の課題を監査するのは
/rhdh-jira-refineです。 - フィールド ID、コンポーネントカタログ、JQL、
acliの構文、ワークフローの終了条件は/rhdh-jira-apiが担当します。 - 一般的なインタビューの進め方は、名前を指定して呼び出す外部の
grillingスキルが担当します。ここに記載されているのは RHDH 固有の部分のみです。
完了条件
ユーザーがこのスキルを直接呼び出し、結果がそのまま使える完全なドラフトになった場合、返す前に、記入済みのサマリーと説明に対して、flavored な文体で /prose-editing を 1 回実行してください。Jira Wiki マークアップ、テンプレートの見出し、フィールド値、課題キー、リンク、受け入れ条件はそのまま保持してください。/rhdh-jira-create または /rhdh-jira-refine からこのスキルが呼び出された場合は、編集せずに作成結果を返してください。最後に呼び出す側が、文章の仕上げを 1 回行います。
ドラフトで使用したテンプレートと課題タイプが明記されており、テンプレートが求めるすべてのセクションが記入されているか、対象外であることが明示されており、該当するすべての問いかけがマトリクスに従って適用されているか、理由を示して省略されており、提案するサイズには感覚ではなく、参照した尺度が示されていれば完了です。重複チェックでは、実行したクエリと確認した行数を報告してください。ユーザーがまだ見ていないドラフトを根拠に、ここで完了とすることはありません。