跳到主要内容

工具 - 冲刺

冲刺是在看板内划定的工作周期。关闭冲刺时，已完成的工作项会被归档，并自动生成变更日志和可视化报告。

list_sprints​

列出看板的所有冲刺。开放的冲刺排在最前面，其后是按日期排序的已关闭冲刺（最新的在前）。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

响应：

[
  {
    "id": "sprint-001",
    "name": "Sprint 12",
    "status": "open",
    "startDate": "2025-02-10T00:00:00.000Z",
    "endDate": "2025-02-24T00:00:00.000Z",
    "boardId": "b1234567-...",
    "workItemCount": 0,
    "createdAt": "2025-02-10T09:00:00.000Z"
  },
  {
    "id": "sprint-000",
    "name": "Sprint 11",
    "status": "closed",
    "startDate": "2025-01-27T00:00:00.000Z",
    "endDate": "2025-02-09T00:00:00.000Z",
    "boardId": "b1234567-...",
    "workItemCount": 18,
    "createdAt": "2025-01-27T09:00:00.000Z"
  }
]

get_sprint​

根据 ID 获取冲刺，包括工作项数量。

参数：

名称类型必填描述
idstring (UUID)是冲刺 ID

示例：

{
  "id": "sprint-001"
}

get_active_sprint​

获取看板当前开放的冲刺。如果没有开放的冲刺，则返回 null。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

响应：

{
  "id": "sprint-001",
  "name": "Sprint 12",
  "status": "open",
  "startDate": "2025-02-10T00:00:00.000Z",
  "endDate": "2025-02-24T00:00:00.000Z",
  "boardId": "b1234567-...",
  "workItemCount": 0
}

create_sprint​

在看板上创建新冲刺。每个看板同时只允许有一个开放的冲刺。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID
namestring是冲刺名称
startDatestring否ISO 8601 格式的开始日期
endDatestring否ISO 8601 格式的结束日期

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 13",
  "startDate": "2025-02-24",
  "endDate": "2025-03-10"
}

close_sprint​

关闭开放的冲刺。归档所有位于“done”列中的工作项，并将其记录为冲刺工作项。可以选择按日期范围筛选。关闭时会自动生成可视化报告和变更日志。

参数：

名称类型必填描述
sprintIdstring (UUID)是要关闭的冲刺 ID
boardIdstring (UUID)是冲刺的看板 ID
startDatestring否用于按 finishedAt >= startDate 筛选项目的 ISO 8601 开始日期
endDatestring否用于按 finishedAt <= endDate 筛选项目的 ISO 8601 结束日期

示例：

{
  "sprintId": "sprint-001",
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

close_sprint_adhoc​

在单个事务中创建并关闭冲刺。适用于追溯记录已完成的冲刺。可以选择按日期范围筛选项目。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID
namestring是冲刺名称
startDatestring否用于筛选项目的 ISO 8601 开始日期
endDatestring否用于筛选项目的 ISO 8601 结束日期

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 10 (retroactive)",
  "startDate": "2025-01-13",
  "endDate": "2025-01-26"
}

close_sprint_by_date​

在单个事务中使用明确的开始和结束日期创建并关闭冲刺。归档当前位于“done”列中的所有工作项。开始和结束日期为必填项。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID
namestring是冲刺名称
startDatestring是ISO 8601 开始日期（例如：2025-01-01）
endDatestring是ISO 8601 结束日期（例如：2025-01-14）

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 9",
  "startDate": "2025-01-01",
  "endDate": "2025-01-14"
}

get_sprint_work_items​

列出特定冲刺中所有已完成并已归档的工作项。

参数：

名称类型必填描述
sprintIdstring (UUID)是冲刺 ID

示例：

{
  "sprintId": "sprint-000"
}

preview_done_items​

预览关闭冲刺时将被归档的“done”列中的工作项。适用于在执行 close_sprint 前进行检查。

参数：

名称类型必填描述
boardIdstring (UUID)是看板 ID

示例：

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

响应：

[
  {
    "id": "wi-001",
    "taskId": "A-T-37",
    "title": "Implement login",
    "type": "task",
    "columnName": "Done",
    "finishedAt": "2025-02-20T15:30:00.000Z"
  },
  {
    "id": "wi-002",
    "taskId": "A-T-38",
    "title": "Auth integration tests",
    "type": "task",
    "columnName": "Done",
    "finishedAt": "2025-02-21T10:00:00.000Z"
  }
]
推荐流程

关闭冲刺前，运行 preview_done_items 以确认将归档正确的项目。然后执行 close_sprint 或 close_sprint_adhoc。

regenerate_sprint_changelog​

重新生成已关闭冲刺的变更日志文档。适用于在改进提示词后重新生成，或为缺少变更日志的旧冲刺生成文档。

参数：

名称类型必填描述
sprintIdstring (UUID)是冲刺 ID（必须已关闭）
fallbackStrategystring否没有 AI 文档的项目所采用的策略：list-only（默认值，仅列出而不提供摘要）、ai-analyze（即时生成 AI 摘要）、skip（省略没有文档的项目）

示例：

{
  "sprintId": "sprint-000",
  "fallbackStrategy": "ai-analyze"
}

响应：

{
  "message": "Changelog generated successfully for sprint 'Sprint 11'",
  "documentId": "doc-uuid-001"
}