SuperAPI AI 工具集

glab-workitems

办公与效率

查看项目

更新于 10-16 01:10

技能介绍

用途:glab work-items 用于操作 GitLab 的统一工作跟踪模型,覆盖任务、OKR、目标、关键结果、史诗、事件、测试用例等规划对象。该命令族在上游仍标记为实验性,命令形态可能变化,可用性因 GitLab 版本或功能开关而异,部分类型仅在群组范围有意义;日常标准 issue 流程建议使用 glab issue。

主要能力:list 支持按类型、状态过滤,支持 --per-page(最大 100)、--after 游标分页和 --output json;create 通过 --type 指定类型,支持 --title、--description、--description-file、--confidential、--attach;update 支持修改标题、描述、指派人、里程碑、起止日期、权重及附件;delete 按 IID 删除。支持的类型包括 epic、incident、issue、key_result、objective、requirement、task、test_case、ticket。

使用方式:默认作用于当前仓库项目,可用 --repo owner/project 切换项目,用 --group my-group 指定群组/子群组。多行描述可用 --description-file <path> 或 --description-file - 从标准输入读取,与 --description 互斥。--attach <path> 上传文件并把返回的 Markdown 引用追加到描述,可重复使用,--attach - 表示从标准输入读取一个附件;附件上传为项目范围,不能与 --group 同时使用。

适用场景:需要区分工作项类型本身时使用,例如群组级史诗、OKR、目标与关键结果,或项目级任务、事件、测试用例。

限制:实验性功能,命令可能变化;并非所有 GitLab 实例都暴露全部类型;delete 具有破坏性,按所选项目或群组范围内的 IID 执行,运行前应确认范围;若提示命令不存在,可用 glab work-items --help 检查本地可用性并升级 glab。