mcpField
R
rhdh-jira-authoring

rhdh-jira-authoring

github.com/redhat-developer開発1955 回インストール1 日前に更新
リポジトリ

rhdh-jira-authoring について

rhdh-jira-authoring は、Jira 課題の作成とレビューに使う RHDH 固有のガイドを提供するスキルです。テンプレート、フィールド推定、見積もり、重複確認、作業分解を扱い、Jira コマンドの実行や書き込みは行いません。

主な機能

  1. 01RHDH 課題テンプレートと例
  2. 02草稿への問いかけとフィールド推定
  3. 03課題サイズの見積もりガイド
  4. 04重複確認のガイド
  5. 05Feature と Epic の分解

活用シーン

  1. 01RHDH Jira 課題の起草
  2. 02草稿の情報不足を確認
  3. 03定義済み尺度で課題を見積もり
  4. 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.yaml
assets/examples/
bug-example.txt
epic-example.txt
feature-example.txt
story-example.txt
task-example.txt
assets/templates/
bug.txt
epic.txt
feature.txt
story.txt
task.txt
references/
duplicates.md
grill.md
sizing.md
work-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 のレビュアーが期待する詳細度が十分に示されないため、ドラフトを作成する前に例を読んでください。

課題タイプ通常のプロジェクトテンプレート例
FeatureRHDHPLANassets/templates/feature.txtassets/examples/feature-example.txt
EpicRHIDPassets/templates/epic.txtassets/examples/epic-example.txt
StoryRHIDPassets/templates/story.txtassets/examples/story-example.txt
TaskRHIDPassets/templates/task.txtassets/examples/task-example.txt
BugRHDHBUGSassets/templates/bug.txtassets/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 回行います。

ドラフトで使用したテンプレートと課題タイプが明記されており、テンプレートが求めるすべてのセクションが記入されているか、対象外であることが明示されており、該当するすべての問いかけがマトリクスに従って適用されているか、理由を示して省略されており、提案するサイズには感覚ではなく、参照した尺度が示されていれば完了です。重複チェックでは、実行したクエリと確認した行数を報告してください。ユーザーがまだ見ていないドラフトを根拠に、ここで完了とすることはありません。

コメント