boards-work-item-summary について
IDを指定して Azure DevOps の作業項目を取得し、関連項目やコメントとともに要約するスキルです。情報収集の手順と表形式の出力を定めています。
主な機能
- 01IDによる作業項目の取得
- 02関連作業項目の詳細取得
- 03コメントの一覧表示
- 04プルリクエストの個別表示
- 05説明と再現手順の要約
活用シーン
- 01作業項目と関連項目の確認
- 02課題のコメントや決定事項の確認
- 03関連プルリクエストの要約
MCP 対応
Azure DevOps MCP Server のツールを使い、作業項目の詳細、関連項目、コメントを取得します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoft/ azure-devops-skills --skill boards-work-item-summaryインストール後、Claude Code で/boards-work-item-summaryを入力して読み込まれたか確認します。
詳細
作業項目を取得する
このスキルでは、常に特定の作業項目 ID を 1 つ扱います。
- ユーザーが ID(例:「115770 の作業項目」や「作業項目 115770」)を指定した場合は、その ID を直接使用します。
- ユーザーが ID を指定していない場合は、作業項目 ID を一度だけ尋ねます。
- 尋ねた後も ID が提供されない場合は、処理を中止し、作業項目 ID が必要であることを明確に伝え、ツールを呼び出さないでください。
ツール
Azure DevOps とのすべてのやり取りには、Azure DevOps MCP Server のツールを使用します。
wit_work_item(action:get):ID を指定して Azure DevOps から作業項目を取得します。wit_work_item(action:list_comments):ID を指定して作業項目のコメント一覧を取得します。wit_work_item(action:get_batch):ID を指定して作業項目の詳細を一括取得します。wit_work_itemの actiongetから返されたリンクを使用し、リンクされた作業項目の詳細を取得します。
手順
-
要求された ID について、フィールド、リレーション、リンクを 1 回の呼び出しで取得できるよう、
expand=allを指定して actiongetでwit_work_itemを呼び出します。 -
作業項目に親がある場合(例:
System.ParentまたはSystem.LinkTypes.Hierarchy-Reverseリレーション)、要約対象のリンク ID 一覧に親 ID を含めます。別途呼び出す必要はありません。次の手順でwit_work_itemの actionget_batchを使用します。 -
作業項目の
relations配列から、リンクされたすべての作業項目 ID(親、子、関連、その他すべて)を収集します。その ID 一覧を使ってwit_work_itemの actionget_batchを 1 回呼び出し、リンクされたすべての作業項目の詳細を取得します。 -
action
list_commentsでwit_work_itemを 1 回呼び出し、元の作業項目のコメントを取得します。
結果の表示
結果を表示するときは、次の項目に従います。
-
メインの作業項目について、次のフィールドを表示します:Id、Title、State、Assigned To(メールアドレスではなく表示名のみ)、Work Item Type、
MM/DD/YYYY形式のCreated Date、Priority、Tags。 -
Links テーブルを表示します。リンクされた作業項目ごとに、次の項目を表示します。
- Id は、次の形式のクリック可能なハイパーリンクにします:
[{ID}](https://dev.azure.com/{organization}/{project}/_workitems/edit/{ID}) - Link type(例:Parent、Child、Related、または元のリレーション名)
- Work item type
- Title
- State
行は次の順番でグループ化し、並べます:親リンクを最初に、次に子リンク、関連リンク、最後にその他のリンクタイプ。
- Id は、次の形式のクリック可能なハイパーリンクにします:
-
作業項目にプルリクエストがリンクされている場合(例:アーティファクトリンクや特定の PR リレーション)、PR ID、タイトル、ステータス、PR へのクリック可能なリンクを含むPull Requests テーブルを別途表示します。
-
作業項目の説明、システム情報、再現手順(これらのフィールドが存在する場合)を、簡潔で平易な言葉で要約します。主な目的、対象範囲、重要な技術情報や再現に関する詳細に重点を置きます。
-
コメントについて:
- コメントが 1 件以上ある場合は、コメントの合計数を示し、主なテーマや決定事項を簡潔にまとめます。
- コメントがない場合は、この作業項目にコメントがないことを明記します。