gitlab-milestone

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Milestone Skill

里程碑技能

Milestone management operations for GitLab using the

glab

CLI.

使用

glab

CLI进行GitLab里程碑管理操作。

Quick Reference

快速参考

Operation	Command	Risk
List milestones	`glab milestone list`	-
Create milestone	`glab milestone create <title>`	⚠️

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

操作	命令	风险
列出里程碑	`glab milestone list`	-
创建里程碑	`glab milestone create <title>`	⚠️

风险说明：- 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危险

When to Use This Skill

何时使用此技能

ALWAYS use when:

User wants to manage project milestones
User mentions "milestone", "sprint", "iteration", "release planning"
User wants to organize work into time-boxed periods

NEVER use when:

User wants to assign milestones to issues (use gitlab-issue)
User wants to create releases (use gitlab-release)

请务必在以下场景使用：

用户需要管理项目里程碑
用户提及“里程碑”、“冲刺”、“迭代”、“发布规划”
用户希望将工作按时间段划分

请勿在以下场景使用：

用户需要为议题分配里程碑（使用gitlab-issue技能）
用户需要创建发布版本（使用gitlab-release技能）

Available Commands

可用命令

List Milestones

列出里程碑

bash

glab milestone list [options]

Options:

Flag	Description
`-s, --state=<state>`	Filter by state: active, closed, all
`-P, --per-page=<n>`	Results per page
`--all`	Get all milestones

Examples:

bash

undefined

bash

glab milestone list [options]

选项：

标识	描述
`-s, --state=<state>`	按状态筛选：active（活跃）、closed（已关闭）、all（全部）
`-P, --per-page=<n>`	每页结果数量
`--all`	获取所有里程碑

示例：

bash

undefined

List active milestones

列出活跃里程碑

glab milestone list

List all milestones including closed

列出所有里程碑（包括已关闭的）

glab milestone list --state=all

List closed milestones

列出已关闭的里程碑

glab milestone list --state=closed

List with more results

列出更多结果

glab milestone list --per-page=50

undefined

glab milestone list --per-page=50

undefined

Create Milestone

创建里程碑

bash

glab milestone create <title> [options]

Options:

Flag	Description
`-d, --description=<desc>`	Milestone description
`--due-date=<date>`	Due date (YYYY-MM-DD format)
`--start-date=<date>`	Start date (YYYY-MM-DD format)

Examples:

bash

undefined

bash

glab milestone create <title> [options]

选项：

标识	描述
`-d, --description=<desc>`	里程碑描述
`--due-date=<date>`	截止日期（格式为YYYY-MM-DD）
`--start-date=<date>`	开始日期（格式为YYYY-MM-DD）

示例：

bash

undefined

Create simple milestone

创建简单里程碑

glab milestone create "Sprint 1"

Create with description

创建带描述的里程碑

glab milestone create "Q1 Release"
-d "Features planned for Q1 2024 release"

glab milestone create "Q1 Release"
-d "2024年第一季度发布计划的功能"

Create with dates

创建带日期的里程碑

glab milestone create "Sprint 5"
--start-date=2024-02-01
--due-date=2024-02-14
-d "Two-week sprint"

glab milestone create "Sprint 5"
--start-date=2024-02-01
--due-date=2024-02-14
-d "两周的冲刺"

Create release milestone

创建发布里程碑

glab milestone create "v2.0.0"
--due-date=2024-03-15
-d "Major version 2.0 release"

undefined

glab milestone create "v2.0.0"
--due-date=2024-03-15
-d "2.0版本主要发布"

undefined

Common Workflows

常见工作流

Workflow 1: Sprint Planning

工作流1：冲刺规划

bash

undefined

bash

undefined

1. Create new sprint milestone

1. 创建新的冲刺里程碑

glab milestone create "Sprint 12"
--start-date=2024-03-01
--due-date=2024-03-14
-d "Sprint 12 goals:

Complete authentication feature
Fix critical bugs
Improve test coverage"

glab milestone create "Sprint 12"
--start-date=2024-03-01
--due-date=2024-03-14
-d "Sprint 12目标：

完成认证功能
修复关键bug
提高测试覆盖率"

2. Assign issues to milestone

2. 为议题分配里程碑

glab issue update 101 -m "Sprint 12" glab issue update 102 -m "Sprint 12" glab issue update 103 -m "Sprint 12"

3. View sprint issues

3. 查看冲刺议题

glab issue list --milestone="Sprint 12"

undefined

glab issue list --milestone="Sprint 12"

undefined

Workflow 2: Release Planning

工作流2：发布规划

bash

undefined

bash

undefined

1. List current milestones

1. 列出当前里程碑

glab milestone list

2. Create release milestone

2. 创建发布里程碑

glab milestone create "Release 1.5"
--due-date=2024-04-01
-d "Version 1.5 release including:

New dashboard
Performance improvements
Bug fixes from user feedback"

glab milestone create "Release 1.5"
--due-date=2024-04-01
-d "1.5版本发布包含：

新的仪表盘
性能优化
根据用户反馈修复bug"

3. Associate issues

3. 关联议题

glab issue list --label="release-1.5" | while read issue; do glab issue update $issue -m "Release 1.5" done

undefined

glab issue list --label="release-1.5" | while read issue; do glab issue update $issue -m "Release 1.5" done

undefined

Workflow 3: Review Sprint Progress

工作流3：冲刺进度回顾

bash

undefined

bash

undefined

1. List sprint milestones

1. 列出冲刺里程碑

glab milestone list --state=active

2. Check open issues in sprint

2. 查看冲刺中未完成的议题

glab issue list --milestone="Sprint 12" --state=opened

3. Check closed issues

3. 查看已完成的议题

glab issue list --milestone="Sprint 12" --state=closed

4. Check MRs in sprint

4. 查看冲刺中的合并请求

glab mr list --milestone="Sprint 12"

undefined

glab mr list --milestone="Sprint 12"

undefined

Milestone Naming Conventions

里程碑命名规范

Common patterns for milestone names:

Pattern	Example	Use Case
Sprint N	Sprint 1, Sprint 2	Agile sprints
YYYY-QN	2024-Q1, 2024-Q2	Quarterly planning
vX.Y.Z	v1.0.0, v2.1.0	Version releases
YYYY-MM	2024-03, 2024-04	Monthly cycles
Feature Name	"User Authentication"	Feature-based milestones

常见的里程碑命名模式：

模式	示例	使用场景
Sprint N	Sprint 1, Sprint 2	敏捷冲刺
YYYY-QN	2024-Q1, 2024-Q2	季度规划
vX.Y.Z	v1.0.0, v2.1.0	版本发布
YYYY-MM	2024-03, 2024-04	月度周期
功能名称	"用户认证"	基于功能的里程碑

Troubleshooting

故障排除

Issue	Cause	Solution
Authentication failed	Invalid/expired token	Run `glab auth login`
Milestone not found	Wrong name or closed	Check with `glab milestone list --state=all`
Invalid date	Wrong format	Use YYYY-MM-DD format
Permission denied	Not maintainer	Need maintainer+ role

问题	原因	解决方案
认证失败	Token无效/过期	运行 `glab auth login`
未找到里程碑	名称错误或已关闭	使用 `glab milestone list --state=all` 检查
日期无效	格式错误	使用YYYY-MM-DD格式
权限不足	不是维护者	需要维护者及以上角色

gitlab-milestone

Original

Translation

Milestone Skill

里程碑技能

Quick Reference

快速参考

When to Use This Skill

何时使用此技能

Available Commands

可用命令

List Milestones

列出里程碑

List active milestones

列出活跃里程碑

List all milestones including closed

列出所有里程碑（包括已关闭的）

List closed milestones

列出已关闭的里程碑

List with more results

列出更多结果

Create Milestone

创建里程碑

Create simple milestone

创建简单里程碑

Create with description

创建带描述的里程碑

Create with dates

创建带日期的里程碑

Create release milestone

创建发布里程碑

Common Workflows

常见工作流

Workflow 1: Sprint Planning

工作流1：冲刺规划

1. Create new sprint milestone

1. 创建新的冲刺里程碑

2. Assign issues to milestone

2. 为议题分配里程碑

3. View sprint issues

3. 查看冲刺议题

Workflow 2: Release Planning

工作流2：发布规划

1. List current milestones

1. 列出当前里程碑

2. Create release milestone

2. 创建发布里程碑

3. Associate issues

3. 关联议题

Workflow 3: Review Sprint Progress

工作流3：冲刺进度回顾

1. List sprint milestones

1. 列出冲刺里程碑

2. Check open issues in sprint

2. 查看冲刺中未完成的议题

3. Check closed issues

3. 查看已完成的议题

4. Check MRs in sprint

4. 查看冲刺中的合并请求

Milestone Naming Conventions

里程碑命名规范

Troubleshooting

故障排除

Related Documentation

相关文档