work-iterations

スキルの指示

このスキルは常にプロジェクトのコンテキストで動作します。チームは任意であり、イテレーションを割り当てる場合、または特定のチームのイテレーションを一覧表示する場合にのみ必要です。

プロジェクトの選択

• ユーザーがリクエストでプロジェクト名を指定した場合（例：「Contoso の場合」）、そのプロジェクトを直接使用し、core_list_projects を呼び出さないでください。
• ユーザーがプロジェクト名を指定していない場合は、まず一度だけプロジェクト名を尋ねてください。
• 一度尋ねてもプロジェクト名が指定されない場合は、core_list_projects を呼び出して、ユーザーが選択できるプロジェクトの一覧を返してください。

チームの選択

• チームが指定されていない場合は、プロジェクトのみのコンテキストを必要とする操作（プロジェクトレベルのイテレーションの一覧表示または作成）のみを実行してください。イテレーションの割り当ては試みないでください。
• ユーザーがイテレーションの割り当てを依頼し、チームが指定されていない場合は、一度だけチーム名を尋ねてください。
• 一度尋ねてもチーム名が指定されない場合は、選択されたプロジェクトに対して core_list_project_teams を呼び出し、ユーザーがチームを選べるようにしてください。

ツール

Azure DevOps とのすべてのやり取りには、Azure DevOps MCP Server のツールを使用してください。

• core_list_projects：組織内のプロジェクト一覧を取得します。
• core_list_project_teams：プロジェクトのチーム一覧を取得します。
• work_iteration_write（アクション：create）：プロジェクトにイテレーションを作成します。
• work_iteration_write（アクション：assign）：チームにイテレーションを割り当てます。
• work（アクション：list_team_iterations）：チームに現在割り当てられているイテレーションを一覧表示します。
• work（アクション：list_iterations）：プロジェクトのイテレーションを一覧表示します。

ルール

1. プロジェクトのイテレーションを一覧表示する

• ユーザーがプロジェクトのイテレーションの一覧表示のみを依頼した場合は、そのプロジェクトに対してアクション list_iterations を指定して work を呼び出してください。
• この場合、work_iteration_write は呼び出さないでください。
• イテレーション名と日付を含めて、結果をリストで表示してください。
• イテレーションがない場合は、このプロジェクトにイテレーションがないことを明示してください。

例

• 「プロジェクト Contoso のイテレーションを一覧表示」

2. プロジェクトとチームのイテレーションを一覧表示する

• ユーザーが特定のプロジェクトとチームのイテレーション一覧表示を依頼した場合は、指定されたプロジェクトとチームに対してアクション list_team_iterations を指定して work を呼び出してください。
• この場合、work_iteration_write は呼び出さないでください。
• イテレーション名と日付を含めて、結果をリストで表示してください。
• イテレーションがない場合は、このチームにイテレーションがないことを明示してください。

例

• 「プロジェクト Contoso とチーム Contoso のイテレーションを一覧表示」

3. プロジェクトにイテレーションを作成する

• ユーザーがプロジェクトのイテレーション作成を依頼した場合は、アクション create を指定して work_iteration_write ツールを使用してください。
• まず、現在のイテレーションをすべて取得し、既存の日付の周期（開始日と終了日、およびイテレーションの長さ）を判断するために、アクション list_iterations を指定して work を呼び出してください。
• その周期に基づいて新しいイテレーションを作成し、アクション create を指定して work_iteration_write に渡してください。
• 作成後、新しいイテレーションを、名前と日付を含めてリストで表示してください。
• イテレーションが作成されなかった場合は、このプロジェクトでイテレーションが作成されなかったことを明示してください。

例 1

• 「最後に利用可能なイテレーションの後から、同じ周期で 2026 年までイテレーションを作成する」

  • 現在のイテレーションをすべて取得し、既存の日付の周期を判断するために、アクション list_iterations を指定して work を呼び出します。
  • その日付の周期に基づいて新しいイテレーションを作成し、アクション create を指定して work_iteration_write に渡します。

例 2

• 「最後に利用可能なイテレーションの後に、同じ周期で2026年までイテレーションを作成してください。その後、新しく作成したイテレーションをすべてチーム『Contoso Team』に割り当ててください」

  • work をアクション list_iterations で呼び出し、現在のイテレーションの全リストを取得して、既存の日付の周期を確認します。
  • その日付の周期に沿って新しいイテレーションを作成し、アクション create を指定して work_iteration_write に渡します。
  • 作成したイテレーションを取得し、アクション assign を指定して work_iteration_write を使用し、チーム「Contoso Team」に割り当てます。
  • 作成したイテレーションを表示します（必要に応じて、指定されたチームに割り当てられていることも記載します）。

4. イテレーションをチームに割り当てる

• ユーザーがイテレーションをチームに割り当てるよう求めた場合は、アクション assign を指定して work_iteration_write を使用します。
• 上記のルールに従って、プロジェクトとチームが選択されていることを確認します。
• 割り当てたイテレーションを、イテレーション名と日付を含むリストで表示します。
• イテレーションが割り当てられていない場合は、このチームに割り当てられたイテレーションがないことを明示します。

例 1

• 「『Iteration 1』、『Iteration 2』、『Iteration 3』をチーム『Contoso Team』に割り当ててください」

  • 割り当てるイテレーションのリストとチーム名を指定して、アクション assign で work_iteration_write を呼び出し、それらのイテレーションをチームに割り当てます。

例 2

• 「2025年と2026年のイテレーションをすべてチーム『Contoso Team』に割り当ててください」

  • work をアクション list_iterations で呼び出し、イテレーションの全リストを取得します。
  • リストから、2025年と2026年に該当するイテレーションを見つけます。
  • 2025年と2026年に該当するイテレーションを取得し、ツール work_iteration_write をアクション assign で使用して、チーム「Contoso Team」に割り当てます。
  • 割り当てたイテレーションをリストで表示します。