twg-jira

twg-jira

Jira が信頼できる情報源である場合、または Jira の変更が必要な場合は、ルートの twg スキルと併用してください。このスキルは Jira の仕様と安全性を担い、コマンドの構文は twg help の最新情報に従います。

CLI ランチャーのフォールバック

twg <command> を実行します。シェルで command not found が発生した場合は、$HOME/.local/bin/twg（macOS/Linux）または $env:LOCALAPPDATA\Programs\twg\bin\twg.exe（PowerShell）を使用し、そのディレクトリを PATH に追加するようユーザーに伝えてください。認証エラーやコマンドエラーを PATH の問題として扱わないでください。

使用する場合

• Jira キー、課題 URL、プロジェクトキー、ボード、スプリント、フィルター、ダッシュボードが主な手がかりである場合。
• Jira の作業項目の作成、更新、トランジション、コメント追加、リンク、ウォッチ、削除をユーザーが依頼した場合。
• Jira の重複する作業項目の検索やレビューをユーザーが依頼した場合。
• 必須フィールドやカスタムフィールドを確認して入力する必要がある場合。
• ワークフロースキルで、信頼できる Jira のフィールドやステータスが必要な場合。

Jira が複数製品にまたがる回答の補助的な情報として登場するだけの場合は、このスキルを読み込まないでください。

最初のルート

意図	ルート
既知の作業項目	ネイティブの作業項目 get
複数の既知の作業項目	すべてのキーを指定した 1 回の get／bulk-get
Jira 内の曖昧なテキスト検索	作業項目 search（JQL ベース）
Jira の厳密なフィルタリング	JQL を指定した作業項目 query
Jira の意味的な検索	rovo search --app jira
作業項目の重複検出	references/duplicates.md
関連するアーティファクトや人物	ネイティブの読み取りと context
実装アーティファクトのリンク	jira workitem link
作成または更新	フィールドメタデータを確認してから変更
ワークフロー状態の変更	トランジションを確認してから実行
ボードまたはスプリントの順序付け	ボード／バックログ／スプリントのコマンド
Jira の設定	Jira 管理名前空間

不慣れな変更や重大な変更を行う前に、twg help describe "<exact path>" を 1 回実行して、対象を絞って確認してください。

Jira の仕様

• ユーザーの表現では、「issue」と「workitem」は同じ Jira オブジェクトを指します。
• Jira のプロジェクト／スペースは Atlas のプロジェクトではありません。課題コンテナー、スキーム、ボード、バージョン、コンポーネント、フィルター、ダッシュボードには Jira を使用してください。
• JSM リクエストの基盤には Jira の作業項目がありますが、承認、ポータル、キュー、リクエストタイプ、SLA は JSM に属します。
• 検索結果は候補となる手がかりです。最終的なフィールドとステータスは、ネイティブの作業項目読み取りで確認してください。通常の get では追加のデータ取得は行われません。--comments や --remote-links を追加するか、両方を含む全フィールドを取得するには --full を指定してください。
• 「次に何を選ぶべきか」と尋ねられた場合は、実際にオープン中の Jira 作業項目、または指定されたボードのバックログを照会してください。広範なアクティビティだけをもとに順位付けしないでください。
• 作業項目の一括読み取りには、jira workitem get、jira workitem bulk-get、context jira workitem のいずれも、すべてのキーを一度に指定できます。キーのリストに対して get を繰り返し実行しないでください。フィールドをクエリできる場合は、jira workitem query --jql <jql> --fields <fields> を使用し、追加のデータ取得は省略してください。

安全な読み取りと書き込み

• 変更を行う前に、サイトと作業項目キーを解決します。
• 更新、トランジション、リンク、コメント、削除を行う前に、現在の状態を読み取ります。
• 必須フィールドやカスタムフィールドを指定する前に、作成／更新用のフィールドメタデータを確認します。
• 書き込み時には表示名ではなく、返された customfield_* ID を使用します。
• トランジション名や ID を推測せず、利用可能なトランジションを確認します。
  • --transition-id を指定せずに twg jira workitem transition --id <KEY> --site <SITE> -o json を実行して、利用可能なトランジションと必須画面フィールドを確認します。
  • いずれかを選択し、その requirements を使ってフィールド値を収集してから、--transition-id を指定して呼び出します。
  • 必須フィールドはユーザーが決定する入力として扱います。ユーザーが必須値を指定していない場合は、推測したり、選択可能な値から選んだりせず、トランジションを実行する前にユーザーに確認します。これには Resolution も含まれます。キャンセルの依頼があっても、Won't Do、Declined、Duplicate、その他の Resolution を意味するとは限りません。
  • この確認用の呼び出しは読み取り専用であり、作業項目のトランジションは実行しません。
• Jira のグローバルフィールド管理と、作業項目のフィールド値を分けて扱います。
• 型付きの作業項目アーティファクトリンクを使って、PR、リポジトリ、デプロイ、ビルド、ブランチ、コミット、Loom 動画、会議への Jira リモートリンクを追加します。これらは Jira Software の devinfo／プロバイダーへの書き込みではありません。
• ネイティブの読み取りで変更を検証し、結果のキーと URL を報告します。

引き継ぎ

• 依存関係、関連ドキュメント、実装リンクについては twg-context-discovery を、担当者、専門家、権限、エスカレーションについては twg-responsibility-routing を読み込みます。
• プロジェクト、スプリント、チーム、リーダーシップ向けの概要については twg-status-rollups を読み込みます。
• Jira のアンカーから PR やリポジトリをたどる必要がある場合は twg-engineering-work を読み込みます。
• インシデント、PIR、信頼性のワークフローについては twg-operational-health を読み込みます。

参考資料

• references/workitems.md - 作業項目の読み取り、書き込み、コメント、リンク
• references/fields-and-transitions.md - メタデータを先に確認するフィールドとワークフローの変更
• references/querying.md - JQL とボード／バックログの選択
• references/duplicates.md - プロンプト主導の重複検出とレビュー
• references/rich-content.md - 説明、コメント、メンション
• references/administration.md - Jira の設定と作業項目データ