XHGit · 产品文档

项目看板与里程碑

通过看板、迭代和里程碑组织团队工作。

01

阅读导览

项目看板用于把议题和合并请求组织成可视工作队列,里程碑用于描述一次版本或阶段交付。看板的列、议题开放状态和里程碑完成度是不同维度;团队应约定各自含义,避免把“移动到完成列”误认为所有工作已经发布。

02

选择项目的归属范围

仓库项目适合一个代码库的任务,入口是仓库“项目”,路径为 /拥有者/仓库/projects。拥有者级项目从个人或组织的项目入口访问,适合组织授权范围内的工作。项目入口是否显示,取决于站点功能、仓库项目模式和你的项目读取权限。

  1. 先明确项目属于哪个仓库或组织。
  2. 确认维护成员有项目写入权限,普通观察者只需读取权限。
  3. 核对相关议题本身的权限;被加入看板不会自动向其他人公开私有议题。
03

建立第一张看板

  1. 打开项目列表,点击新建项目,填写清楚的名称与说明。
  2. 按界面选择可用的看板模板,或根据工作方式创建列。
  3. 为每列约定进入和离开的条件,例如“待安排”“处理中”“待验证”“完成”。
  4. 保存后进入项目,确认列顺序和说明,邀请团队按同一规则使用。

项目说明适合记录目标、负责人和工作规则,详细需求放在议题正文。把每列命名为一个人的姓名通常不利于观察流程,负责人可以通过议题指派字段表达。

04

把议题或合并请求加入项目

  1. 先在仓库创建可执行的议题或合并请求。
  2. 由有权限的成员在事项侧栏选择项目及可用列,或使用项目页面提供的添加入口。
  3. 返回看板确认卡片显示的标题、标签和负责人是否正确。
  4. 处理过程中拖动卡片到适合的列,并同步更新事项中的进度说明。

没有移动或新增按钮时,先核对项目写入权限和仓库是否归档。卡片引用真实事项,编辑标题和讨论应进入原事项页面完成,不要在看板之外另建重复任务。

05

用筛选定位当前工作

项目页面支持按已有标签、指派人和里程碑等条件筛选。先清空上次筛选,再逐个加入条件,能避免误以为卡片被删除。页面提供全屏查看时,可用它在讨论排期时集中查看看板。

列顺序用于说明流程,卡片顺序可以表达团队约定的优先级。操作后刷新检查结果是否保存;网络错误时不要连续拖动多次,应先确认上一次操作是否成功。需要管理列名称、颜色或顺序时,由项目写入者使用列菜单处理。

06

建立可验收的里程碑

  1. 在仓库议题或合并请求区域进入“里程碑”,创建一次交付,例如 v0.2。
  2. 填写目标说明和适合的截止日期,保存后将相关事项分配进去。
  3. 查看开放与已关闭事项,及时拆出不在范围内的工作。
  4. 达到团队约定的验收条件后关闭里程碑,并在版本发布中写明最终交付内容。

里程碑完成比例反映所含事项的状态,不直接代表测试覆盖率或实际工时。关闭里程碑不会自动发布软件,也不会替你决定未关闭事项应该转到哪个版本。

07

区分关闭项目与删除项目

关闭项目适合保留阶段工作记录,之后按权限可重新打开。删除项目会移除该看板的组织信息,执行前应核对名称及页面确认提示。项目删除不等同于删除代码仓库,相关事项的保留情况以确认说明和实际结果为准。

长期项目建议定期整理完成的卡片与过期任务。不要为了让数字好看而关闭仍需处理的议题;将任务拆分成能验证的结果,会比堆积宽泛卡片更有帮助。

08

排查看不到卡片的问题

先检查项目是否关闭、列表筛选是否排除已关闭项目、卡片是否在其他列,以及当前的标签和负责人过滤条件。接着检查原议题和仓库访问权限,最后请管理员确认项目功能是否启用。团队成员与仓库成员的关系见组织与团队,通用问题见故障排查。