里程碑是什么
里程碑是托管平台（GitHub Milestones / GitLab Milestones）里的版本目标容器：把一批议题与合并请求挂到同一目标（如 v2.5），用完成比例、截止时间与剩余清单追踪发布进度。它的价值在发布前那次核对——逐项看 open 项，决定顺延还是移出范围；把它当长期分类标签用，就会退化成过滤器。里程碑收口要与版本标签发布配对执行。
基本信息
| 载体 | 平台里程碑（GitHub Milestones / GitLab Milestones） |
|---|---|
| 用途 | 版本目标追踪，挂载议题与合并请求 |
| 关键字段 | 标题、描述、截止日期、完成百分比 |
| 关闭条件 | 范围清空或明确顺延 |
| 配套动作 | 发布时收口里程碑，与版本标签对应 |
| 检查节奏 | 每次发布前核对剩余项 |
典型使用场景
- 版本规划：把本版本要做的议题归拢，发布范围一目了然
- 进度跟踪：用完成百分比与剩余清单对齐团队状态
- 发布评审：逐项核对，未完成项明确顺延或移出
- 复盘统计：按里程碑统计按期完成率，改进估时与拆解
- 交接审计：范围与时间去向有记录，便于追溯
- 与标签配对：打版本标签时同步关闭对应里程碑
操作示意
操作示意
# GitHub：Issues → Milestones → New milestone 建里程碑
# 给 issue / PR 选择目标 milestone，范围即确定
# 发布前：检查 open 项，决定顺延或移出范围
# 发布后：关闭里程碑，与版本标签对应记录关键字段读法
| 字段 | 含义 | 用法 |
|---|---|---|
| 完成百分比 | 已关闭项占全部项的比例 | 发布前看剩余进度 |
| 截止日期 | 目标完成时间 | 过期未收口要重新决策 |
| Open 清单 | 未完成的范围 | 逐项决定顺延或移出 |
| 描述 | 范围说明 | 写清不做项，防止范围漂移 |
里程碑与版本标签配对使用：发布时把里程碑收口，避免长期漂移。
平台通常允许一个条目只挂一个里程碑：跨版本的条目要拆分或另设跟踪方式，别指望一条挂多个。
创建时就约定截止日期与负责人，否则里程碑会失去规划意义。