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. 列出项目迭代

• 当用户只要求列出项目的迭代时，针对该项目调用 work，并将操作设为 list_iterations。
• 此时不要调用 work_iteration_write。
• 以列表形式显示结果，包括迭代名称和日期。
• 如果没有迭代，请明确说明该项目没有迭代。

示例

• “列出项目 Contoso 的迭代”

2. 列出项目和团队的迭代

• 当用户要求列出特定项目和团队的迭代时，针对指定的项目和团队调用 work，并将操作设为 list_team_iterations。
• 此时不要调用 work_iteration_write。
• 以列表形式显示结果，包括迭代名称和日期。
• 如果没有迭代，请明确说明该团队没有迭代。

示例

• “列出项目 Contoso 和团队 Contoso 的迭代”

3. 为项目创建迭代

• 当用户要求为项目创建迭代时，使用 work_iteration_write 工具，并将操作设为 create。
• 首先，调用 work，并将操作设为 list_iterations，以获取当前迭代的完整列表，并确定现有的日期节奏（开始日期和结束日期，以及迭代时长）。
• 根据该节奏创建新迭代，并将其传递给 work_iteration_write，操作设为 create。
• 创建后，以列表形式显示新迭代，包括迭代名称和日期。
• 如果未创建迭代，请明确说明该项目未创建任何迭代。

示例 1

• “在最后一个可用迭代之后，按照相同的节奏创建迭代，直至 2026 年”

  • 调用 work，并将操作设为 list_iterations，以获取当前迭代的完整列表并确定现有的日期节奏。
  • 根据该日期节奏创建新迭代，并将其传递给 work_iteration_write，操作设为 create。

示例 2

• “使用相同的周期，从最后一个可用迭代之后开始创建迭代，直到 2026 年。然后将所有这些新迭代分配给团队 'Contoso Team'”

  • 调用 work，使用 action list_iterations 获取当前迭代的完整列表，并确定现有的日期周期。
  • 根据该日期周期创建新迭代，并将其传递给 work_iteration_write，使用 action create。
  • 将创建的迭代分配给团队“Contoso Team”，调用 work_iteration_write 并使用 action assign。
  • 显示创建的迭代（如有帮助，可注明这些迭代已分配给指定团队）。

4. 将迭代分配给团队

• 当用户要求将迭代分配给团队时，使用 work_iteration_write，并指定 action assign。
• 确保根据上述规则选择项目和团队。
• 以列表形式显示已分配的迭代，包括迭代名称和日期。
• 如果未分配任何迭代，请明确说明该团队没有已分配的迭代。

示例 1

• “将迭代 'Iteration 1'、'Iteration 2' 和 'Iteration 3' 分配给团队 'Contoso Team'”

  • 调用 work_iteration_write，使用 action assign，并提供要分配的迭代列表和团队名称，将这些迭代分配给该团队。

示例 2

• “将 2025 年和 2026 年的所有迭代分配给团队 'Contoso Team'”

  • 调用 work，使用 action list_iterations 获取迭代的完整列表。
  • 从列表中找出属于 2025 年和 2026 年的迭代。
  • 将属于 2025 年和 2026 年的迭代分配给团队“Contoso Team”，调用工具 work_iteration_write 并使用 action assign。
  • 以列表形式显示已分配的迭代。