目标和里程碑
你有 50 个任务分布在 3 个冲刺中。进展顺利吗？目标让你获得必要的高度，既能纵览全局，又不会迷失于细节。
目标（里程碑）是聚合与特定目标相关的工作项的宏观目标。冲刺按时间组织工作，目标则按预期结果组织工作。
关键概念
- 一个目标属于一个项目，并且可以聚合多个看板中的项。
- 每个目标都有状态、优先级和目标日期。
- 工作项手动关联到目标，因此可以组合来自不同冲刺的工作。
- 进度会根据已完成项自动计算。
- 一个目标可以与同一项目的其他目标同时处于活跃状态。
目标状态
| 状态 | 描述 | 用途 |
|---|---|---|
planned | 已计划，尚未开始 | 未来目标或等待资源的目标 |
in_progress | 活跃进行中 | 正在处理的目标 |
completed | 已完成 | 已成功达成的目标 |
on_hold | 暂停 | 临时搁置的目标 |
cancelled | 已取消 | 不再执行的目标 |
优先级
| 优先级 | 描述 |
|---|---|
urgent | 需要立即处理 |
high | 重要，应尽快执行 |
medium | 标准优先级 |
low | 低优先级，在可能时执行 |
创建目标
- 从主菜单访问 Goals 部分。
- 选择要创建目标的项目。
- 单击 新建目标。
- 填写字段：
| 字段 | 描述 | 必填 |
|---|---|---|
title | 目标名称（例如 "Lanzamiento MVP Auth"） | 是 |
description | 目标的详细描述 | 否 |
priority | 优先级：urgent、high、medium、low | 是 |
targetDate | 目标完成日期 | 是 |
workItemIds | 要关联到目标的项 | 否 |
- 确认创建。
关联工作项
与自动关联项的冲刺不同，目标中的关联是显式的：
- 打开要添加项的目标。
- 选择 添加项。
- 搜索并选择有助于此目标的工作项。
- 确认选择。
创建目标时，也可以使用 workItemIds 字段关联项。
提示
同一个工作项可以关联到多个目标。当某项工作有助于多个目标时，这很有用。
跟踪进度
目标进度会自动计算：
- 总项数：关联到目标的工作项数量。
- 已完成项：位于
isDone = true列中的工作项。 - 百分比：已完成项与总项数的比率。
目标详情视图显示：
- 视觉进度条。
- 按状态分组的项列表（已完成与待处理）。
- 距目标日期的剩余天数。
- 按类型和优先级分布的指标。
编辑目标
- 打开要修改的目标。
- 单击 编辑。
- 修改所需字段（标题、描述、状态、优先级、目标日期）。
- 保存更改。
注意
将状态更改为 completed 会自动设置完成日期。此操作无法自动撤销。
删除目标
删除目标时：
- 会删除与工作项的所有关联。
- 工作项不会被删除，只会失去关联。
- 目标历史记录会永久丢失。
目标与冲刺
| 方面 | 冲刺 | 目标 |
|---|---|---|
| 组织方式 | 按时间（2 周） | 按目标 |
| 范围 | 单个看板 | 多个看板 |
| 项 | 自动关联 | 手动关联 |
| 并行性 | 每个看板一个活跃冲刺 | 多个活跃目标 |
| 报告 | 速度、指标 | 朝向目标的进度 |
使用冲刺来组织团队的日常工作，使用目标来传达面向业务目标的进度。
开发者指南
开发者指南
MCP 工具
| 工具 | 描述 | 主要参数 |
|---|---|---|
list_milestones | 列出项目的所有目标 | projectId |
get_milestone | 获取目标及其工作项 | milestoneId |
get_milestone_progress | 获取进度统计数据 | milestoneId |
create_milestone | 创建新目标 | projectId, title, priority, targetDate, workItemIds |
update_milestone | 更新现有目标 | milestoneId, title, description, status, priority, targetDate |
delete_milestone | 删除目标 | milestoneId |
add_work_items_to_milestone | 将项关联到目标 | milestoneId, workItemIds |
remove_work_item_from_milestone | 取消项与目标的关联 | milestoneId, workItemId |
示例：创建目标
Tool: create_milestone
Parametros:
projectId: "uuid-del-proyecto"
title: "Lanzamiento MVP Autenticacion"
priority: "high"
targetDate: "2026-04-15"
workItemIds: ["uuid-item-1", "uuid-item-2"]
示例：查询进度
Tool: get_milestone_progress
Parametros:
milestoneId: "uuid-del-goal"
返回：
{
"totalItems": 12,
"completedItems": 8,
"progress": 66.67
}
示例：向现有目标添加项
Tool: add_work_items_to_milestone
Parametros:
milestoneId: "uuid-del-goal"
workItemIds: ["uuid-item-3", "uuid-item-4"]