管理议题

本指南介绍如何使用标签（Label）和看板（Board）来组织和管理项目中的议题（Issue）。

理解议题

议题是需要跟踪和完成的任务、缺陷或功能需求。你可以通过以下方式组织议题：

  • 标签 - 按类型或状态对议题进行分类和筛选
  • 看板 - 用代表不同阶段的列来可视化议题工作流
  • 指派人 - 将议题指派给团队成员
  • 状态 - 跟踪议题处于打开还是关闭状态

创建标签

标签帮助你在整个项目中对议题进行分类和组织。

创建标签的步骤：

  1. 进入你的项目
  2. 在左侧边栏进入 Settings → Labels
  3. 点击 New Label 按钮
  4. 输入标签名称（例如 bug、feature、documentation）
  5. 可以选择一种颜色使其在视觉上更易区分
  6. 点击 Create Label

标签可以应用到多个议题上，并用于筛选和搜索相关工作。

使用作用域标签

作用域标签（Scoped Label）是一种特殊的标签，使用 :: 分隔符创建标签层级，并强制同一作用域内互斥。

什么是作用域标签？

作用域标签遵循 scope::value 的格式，例如：

  • workflow::todo - 表示待办状态
  • workflow::working_on - 表示进行中
  • sprint::1 - 表示迭代编号
  • priority::high - 表示优先级

主要特性：

  • 同一作用域内互斥：同一作用域下的标签一次只能给议题分配一个。例如，一个议题不能同时拥有 workflow::todo 和 workflow::working_on。
  • 允许多个作用域：一个议题可以拥有来自不同作用域的多个作用域标签。例如，workflow::todo 和 sprint::1 可以同时分配给同一个议题。
  • 工作流组织：它们特别适合用来创建状态工作流和迭代管理。

创建作用域标签：

与创建普通标签的步骤相同，只需在标签名称中使用 :: 分隔符：

  • workflow::todo
  • workflow::working_on
  • priority::low
  • sprint::1

设置项目看板

项目看板使用列（称为阶段 Stage）来表示不同状态，为你的工作流提供可视化视图。

看板基础：

  • 每个项目一个看板：每个项目只能有一个看板
  • 多个阶段：一个看板可以有多个阶段列（例如 Todo、Working On、Closed）
  • 标签筛选：每个阶段可以分配多个标签，用于筛选显示哪些议题
  • 默认阶段：新项目自带预配置的阶段：Todo、Working On 和 Closed

创建或配置看板：

  1. 进入你的项目
  2. 在左侧边栏进入 Board（新项目会自动创建看板）
  3. 每一列代表一个阶段，并关联相应的工作流标签
  4. 匹配该阶段标签的议题会显示在对应列中

在看板上管理议题：

在阶段之间移动议题：

  1. 点击并拖动议题卡片从一列到另一列
  2. 议题的状态会根据阶段的标签自动更新
  3. 相应的工作流标签会被应用到议题上

自动关闭议题：

  • 当你把议题拖入 Closed 阶段时，它会被自动关闭
  • 已关闭的议题不再被视为进行中的工作

按阶段筛选：

  • 每个阶段只显示拥有该阶段全部所属标签的议题
  • 利用这一点让看板视图聚焦于相关工作

最佳实践：

  • 在整个项目中使用一致的作用域标签
  • 通过分配工作流标签控制哪些议题出现在看板上
  • 使用额外的标签（如 priority 或 sprint）在阶段内筛选和组织工作
  • 定期回顾并关闭已完成的议题，保持看板整洁

更多详情请访问完整文档。

下一篇：使用 AI 机器人技能