冲刺和报告
没有时间限制，工作会无限扩张。冲刺建立节奏：规划、执行、衡量、调整。无论工作由人员还是代理完成，它们都同样有效。每次关闭冲刺都会迫使你评估完成了什么、还有什么未完成以及学到了什么。没有这种纪律，项目会逐渐失焦。
冲刺是在看板内具有时间限制的迭代。它允许你规划在特定期间要完成哪些工作项、跟踪进度，并在结束时生成报告。
关键概念
- 每个看板一次只能有一个活跃冲刺。
- 冲刺具有开始日期、结束日期和目标。
- 看板的工作项会关联到活跃冲刺。
- 关闭冲刺时，系统会自动生成变更日志和绩效指标。
- 先前冲刺的历史记录及其报告会被保留。
创建冲刺
- 访问要创建冲刺的看板。
- 选择 新建冲刺。
- 填写字段：
| 字段 | 描述 | 必填 |
|---|---|---|
name | 冲刺名称（例如 "Sprint 14 - Auth y Permisos"） | 是 |
startDate | 开始日期 | 是 |
endDate | 结束日期 | 是 |
goal | 冲刺目标：希望达成什么 | 否 |
- 确认创建。冲刺会立即变为活跃状态。
注意
每个看板只能有一个活跃冲刺。如果已存在活跃冲刺，必须先关闭它才能创建新冲刺。
关联工作项
当冲刺处于活跃状态时，看板中的工作项即属于该冲刺。没有明确“关联”项到冲刺的操作：冲刺期间看板中的所有项都会被统计。
这意味着：
- 在冲刺期间创建的新项会自动纳入。
- 在冲刺期间移至看板的项会纳入。
- 在冲刺期间归档的项不再统计。
已完成项预览
关闭冲刺前，可以预览哪些项会被视为“done”。Almirant 会识别处于具有 isDone = true 角色的列中的项，并将其显示为已完成候选项。
这样，你可以在关闭前验证是否有项尚未移至正确的列。
关闭冲刺
有三种关闭方式，分别适用于不同场景：
1. 常规关闭
在计划周期结束时进行的标准关闭。
- 访问看板的活跃冲刺。
- 选择 关闭冲刺。
- 查看已完成项与未完成项的摘要。
- 决定如何处理未完成项（移至待办列表或下一个冲刺）。
- 确认关闭。
2. 临时关闭
在计划日期前决定结束冲刺时提前关闭。当需要重新规划工作或目标发生变化时很有用。
- 访问活跃冲刺。
- 选择 临时关闭冲刺。
- 检查并确认。未完成项的处理方式与常规关闭相同。
3. 按日期关闭
基于特定日期的自动关闭。适用于结束日期与原计划不同的冲刺。
- 访问活跃冲刺。
- 选择 按日期关闭。
- 指定截止日期。
- 在该日期之前完成的项将计为已完成。
未完成项
关闭冲刺时，不在 isDone 列中的工作项被视为未完成。你可以：
- 移至待办列表 -- 项会回到默认列以重新确定优先级。
- 纳入下一个冲刺 -- 项保留在当前列，并在新冲刺中统计。
自动变更日志
关闭冲刺时，Almirant 会自动生成变更日志，其中包括：
- 按类型分组的已完成项列表。
- 冲刺期间完成变更的摘要。
- 从项中提取的相关备注。
如有必要，可使用 regenerate_sprint_changelog 工具重新生成变更日志。
报告和指标
每个已关闭冲刺都会生成包含以下指标的报告：
| 指标 | 描述 |
|---|---|
| 速度（velocity） | 冲刺中完成的项数 |
| 按类型分布 | 按类型细分完成项（epic、feature、story、task） |
| 按优先级分布 | 按优先级细分（urgent、high、medium、low） |
| 按受分配人分布 | 每位团队成员完成的工作 |
| AI 成本 | 冲刺期间执行的 AI 会话总成本 |
| 与先前冲刺比较 | 相对于先前冲刺的速度和指标变化 |
报告包括图形可视化，并可附加截图以记录冲刺关闭时的产品状态。
冲刺历史记录
所有已关闭冲刺都会保留在看板历史记录中。你可以访问任何先前冲刺以查看：
- 指标报告。
- 生成的变更日志。
- 属于该冲刺的工作项。
- 附加的截图。
开发者指南
开发者指南
MCP 工具
| 工具 | 描述 | 主要参数 |
|---|---|---|
list_sprints | 列出看板的所有冲刺 | boardId |
get_sprint | 获取冲刺详情 | sprintId |
get_active_sprint | 获取看板的活跃冲刺 | boardId |
create_sprint | 创建新冲刺 | boardId, name, startDate, endDate, goal |
close_sprint | 关闭活跃冲刺（常规） | sprintId |
close_sprint_adhoc | 提前关闭冲刺 | sprintId |
close_sprint_by_date | 按截止日期关闭冲刺 | sprintId, date |
get_sprint_work_items | 获取与冲刺关联的项 | sprintId |
preview_done_items | 关闭前预览已完成项 | sprintId |
regenerate_sprint_changelog | 重新生成已关闭冲刺的变更日志 | sprintId |
示例：创建冲刺
Tool: create_sprint
Parametros:
boardId: "uuid-del-board"
name: "Sprint 14 - Autenticacion"
startDate: "2025-03-01"
endDate: "2025-03-14"
goal: "Completar el sistema de login con Google OAuth y roles de usuario"
示例：预览已完成项
Tool: preview_done_items
Parametros:
sprintId: "uuid-del-sprint"
返回关闭冲刺时将标记为已完成的项列表，以便在关闭前进行验证。
示例：关闭冲刺并生成报告
Tool: close_sprint
Parametros:
sprintId: "uuid-del-sprint"
执行关闭后，系统会自动生成变更日志和冲刺指标。