mcpField
G
gitlab-milestone

gitlab-milestone

github.com/grandcamel开发489 次安装41 周前更新
代码仓库

关于 gitlab-milestone

面向 GitLab 项目维护者的里程碑管理技能，通过 glab CLI 列出和创建里程碑，并支持日期与描述设置。

主要功能

  1. 01列出里程碑并按状态筛选
  2. 02创建带描述的里程碑
  3. 03设置开始日期和截止日期

适用场景

  1. 01规划冲刺或迭代周期
  2. 02整理季度或版本发布计划
  3. 03查看活跃及已关闭里程碑

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/grandcamel/gitlab-assistant-skills --skill gitlab-milestone

安装后在 Claude Code 中输入/gitlab-milestone确认已加载。

详细介绍

里程碑技能

使用 glab CLI 管理 GitLab 里程碑。

快速参考

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

风险说明：- 安全 | ⚠️ 谨慎 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危险

何时使用此技能

始终在以下情况下使用：

  • 用户希望管理项目里程碑
  • 用户提到“里程碑”“冲刺”“迭代”“发布规划”
  • 用户希望将工作安排到有时间限制的周期中

以下情况切勿使用：

  • 用户希望为议题分配里程碑（使用 gitlab-issue）
  • 用户希望创建发布（使用 gitlab-release）

可用命令

列出里程碑
glab milestone list [options]

选项：

标志说明
-s, --state=<state>按状态筛选：active、closed、all
-P, --per-page=<n>每页结果数
--all获取所有里程碑

示例：

# 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
创建里程碑
glab milestone create <title> [options]

选项：

标志说明
-d, --description=<desc>里程碑说明
--due-date=<date>截止日期（YYYY-MM-DD 格式）
--start-date=<date>开始日期（YYYY-MM-DD 格式）

示例：

# Create simple milestone
glab milestone create "Sprint 1"

# Create with description
glab milestone create "Q1 Release" \
  -d "Features planned for Q1 2024 release"

# Create with dates
glab milestone create "Sprint 5" \
  --start-date=2024-02-01 \
  --due-date=2024-02-14 \
  -d "Two-week sprint"

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

常见工作流

工作流 1：冲刺规划
# 1. Create new sprint milestone
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"

# 2. Assign issues to milestone
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
glab issue list --milestone="Sprint 12"
工作流 2：发布规划
# 1. List current milestones
glab milestone list

# 2. Create release milestone
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"

# 3. Associate issues
glab issue list --label="release-1.5" | while read issue; do
  glab issue update $issue -m "Release 1.5"
done
工作流 3：检查冲刺进度
# 1. List sprint milestones
glab milestone list --state=active

# 2. Check open issues in sprint
glab issue list --milestone="Sprint 12" --state=opened

# 3. Check closed issues
glab issue list --milestone="Sprint 12" --state=closed

# 4. Check MRs in sprint
glab mr list --milestone="Sprint 12"

里程碑命名约定

里程碑名称的常见模式：

模式示例使用场景
冲刺 NSprint 1、Sprint 2敏捷冲刺
YYYY-QN2024-Q1、2024-Q2季度规划
vX.Y.Zv1.0.0、v2.1.0版本发布
YYYY-MM2024-03、2024-04月度周期
功能名称“用户身份验证”基于功能的里程碑

故障排除

问题原因解决方案
身份验证失败令牌无效或已过期运行 glab auth login
未找到里程碑名称错误或已关闭使用 glab milestone list --state=all 检查
日期无效格式错误使用 YYYY-MM-DD 格式
权限被拒绝不是维护者需要维护者或更高角色

相关文档

评论

支持 Markdown