glab-workitems

glab workitems

列出和管理 GitLab 工作项——GitLab 中新一代的工作跟踪格式，支持任务（Task）、OKR、关键结果（Key Result）、史诗（Epic）等类型。

glab v1.87.0 新增

什么是工作项？

工作项是 GitLab 的统一工作跟踪模型。它们在传统 Issue 的基础上扩展，支持：

• 任务（Task） — Issue 内的子任务
• OKR — 目标与关键结果
• 关键结果（Key Result） — 与 OKR 关联的可衡量成果
• 史诗（Epic，新一代） — 跨里程碑的大型工作单元
• 事件（Incident） — 关联到事件管理

快速入门

# 列出当前项目的工作项
glab workitems list

# 列出指定项目的工作项
glab workitems list --repo owner/project

# 以 JSON 格式输出
glab workitems list --output json

常见工作流

列出工作项

# 所有工作项（默认：打开状态）
glab workitems list

# 按类型筛选
glab workitems list --type Task
glab workitems list --type OKR
glab workitems list --type KeyResult
glab workitems list --type Epic

# 按状态筛选
glab workitems list --state opened
glab workitems list --state closed

# 以 JSON 格式输出（便于脚本处理）
glab workitems list --output json | python3 -c "
import sys, json
items = json.load(sys.stdin)
for item in items:
    print(f\"{item['iid']}: {item['title']} [{item['type']}]\")
"

指定仓库或群组

# 指定仓库
glab workitems list --repo mygroup/myproject

# 群组级别的工作项
glab workitems list --group mygroup

工作项 vs Issue

功能	Issue	工作项
标准缺陷/功能跟踪	✅	✅
任务（子任务）	❌	✅
OKR / 关键结果	❌	✅
新一代史诗	❌	✅
CLI 支持	完整	list（v1.87.0）

标准 Issue 工作流请使用 glab issue。处理任务、OKR 或新一代史诗时请使用 glab workitems。

故障排查

"workitems: command not found"：

• 需要 glab v1.87.0 或更高版本。使用 glab version 检查。

预期有结果但返回为空：

• 工作项与 Issue 是不同的类型。以 Issue 方式创建的条目不会出现在这里，除非已被转换。
• 在 GitLab 界面中查看项目的"计划 > 工作项"侧边栏。

类型筛选无结果：

• 并非所有 GitLab 实例都启用了全部工作项类型。GitLab SaaS 比私有部署实例支持更多类型。

相关技能

• glab-issue — 标准 Issue 管理
• glab-milestone — 里程碑（常与 OKR 配合使用）
• glab-iteration — 迭代/冲刺管理
• glab-incident — 事件管理（一种工作项类型）

命令参考

glab workitems list [--flags]

Flags:
  --group        Select a group/subgroup
  --output       Format output as: text, json
  --page         Page number
  --per-page     Number of items per page
  --repo         Select a repository
  --state        Filter by state: opened, closed, all
  --type         Filter by work item type
  -h, --help     Show help