Glab Issue

---
name: glab-issue
description: 创建、查看、更新和管理 GitLab 议题。适用于议题跟踪、缺陷报告、功能请求或任务管理等场景。操作包括创建议题、带过滤器列表、查看详情、添加评论/备注、更新标签/指派人/里程碑、关闭/重新打开以及看板管理。触发关键词：议题、缺陷、任务、工单、功能请求、列出议题、创建议题。
---

# glab issue

创建、查看、更新和管理 GitLab 议题（issue）。

## 快速入门

```bash
# Create an issue
glab issue create --title "Fix login bug" --label bug

# List open issues
glab issue list --state opened

# View issue details
glab issue view 123

# Add comment
glab issue note 123 -m "Working on this now"

# Close issue
glab issue close 123
```

## 常用工作流

### 缺陷报告工作流

1. **创建缺陷议题：**
   ```bash
   glab issue create \
     --title "Login fails with 500 error" \
     --label bug \
     --label priority::high \
     --assignee @dev-lead
   ```

2. **添加复现步骤：**
   ```bash
   glab issue note 456 -m "Steps to reproduce:
   1. Navigate to /login
   2. Enter valid credentials
   3. Click submit
   Expected: Dashboard loads
   Actual: 500 error"
   ```

### 议题分类

1. **列出未分类的议题：**
   ```bash
   glab issue list --label needs-triage --state opened
   ```

2. **更新标签和指派人：**
   ```bash
   glab issue update 789 \
     --label backend,priority::medium \
     --assignee @backend-team \
     --milestone "Sprint 23"
   ```

3. **移除分类标签：**
   ```bash
   glab issue update 789 --unlabel needs-triage
   ```

**批量打标签：**

对多个议题批量添加标签：
```bash
scripts/batch-label-issues.sh "priority::high" 100 101 102
scripts/batch-label-issues.sh bug 200 201 202 203
```

### Sprint 规划

**查看当前 Sprint 的议题：**
```bash
glab issue list --milestone "Sprint 23" --assignee @me
```

**添加到 Sprint：**
```bash
glab issue update 456 --milestone "Sprint 23"
```

**看板视图：**
```bash
glab issue board view
```

### 将议题关联到工作

**为议题创建 MR：**
```bash
glab mr for 456  # Creates MR that closes issue #456
```

**自动化工作流（创建分支 + 草稿 MR）：**
```bash
scripts/create-mr-from-issue.sh 456 --create-mr
```

该脚本自动完成：从议题标题创建分支 → 空提交 → 推送 → 创建草稿 MR。

**通过提交/MR 关闭议题：**
```bash
git commit -m "Fix login bug

Closes #456"
```

## 相关技能

**从议题创建 MR：**
- 参见 `glab-mr` 了解合并请求操作
- 使用 `glab mr for <issue-id>` 创建可关闭议题的 MR
- 脚本：`scripts/create-mr-from-issue.sh` 自动化分支创建 + 草稿 MR

**标签管理：**
- 参见 `glab-label` 了解标签的创建和管理
- 脚本：`scripts/batch-label-issues.sh` 用于批量打标签操作

**项目规划：**
- 参见 `glab-milestone` 了解版本规划
- 参见 `glab-iteration` 了解 Sprint/迭代管理

## 命令参考

完整的命令文档和所有参数请参见 [references/commands.md](references/commands.md)。

**可用命令：**
- `create` - 创建新议题
- `list` - 带过滤器列出议题
- `view` - 显示议题详情
- `note` - 为议题添加评论
- `update` - 更新标题、标签、指派人、里程碑
- `close` - 关闭议题
- `reopen` - 重新打开已关闭的议题
- `delete` - 删除议题
- `subscribe` / `unsubscribe` - 管理通知
- `board` - 使用议题看板