阅读导览
项目看板用于把议题和合并请求组织成可视工作队列,里程碑用于描述一次版本或阶段交付。看板的列、议题开放状态和里程碑完成度是不同维度;团队应约定各自含义,避免把“移动到完成列”误认为所有工作已经发布。
选择项目的归属范围
仓库项目适合一个代码库的任务,入口是仓库“项目”,路径为 /拥有者/仓库/projects。拥有者级项目从个人或组织的项目入口访问,适合组织授权范围内的工作。项目入口是否显示,取决于站点功能、仓库项目模式和你的项目读取权限。
- 先明确项目属于哪个仓库或组织。
- 确认维护成员有项目写入权限,普通观察者只需读取权限。
- 核对相关议题本身的权限;被加入看板不会自动向其他人公开私有议题。
建立第一张看板
- 打开项目列表,点击新建项目,填写清楚的名称与说明。
- 按界面选择可用的看板模板,或根据工作方式创建列。
- 为每列约定进入和离开的条件,例如“待安排”“处理中”“待验证”“完成”。
- 保存后进入项目,确认列顺序和说明,邀请团队按同一规则使用。
项目说明适合记录目标、负责人和工作规则,详细需求放在议题正文。把每列命名为一个人的姓名通常不利于观察流程,负责人可以通过议题指派字段表达。
把议题或合并请求加入项目
用筛选定位当前工作
项目页面支持按已有标签、指派人和里程碑等条件筛选。先清空上次筛选,再逐个加入条件,能避免误以为卡片被删除。页面提供全屏查看时,可用它在讨论排期时集中查看看板。
列顺序用于说明流程,卡片顺序可以表达团队约定的优先级。操作后刷新检查结果是否保存;网络错误时不要连续拖动多次,应先确认上一次操作是否成功。需要管理列名称、颜色或顺序时,由项目写入者使用列菜单处理。
建立可验收的里程碑
- 在仓库议题或合并请求区域进入“里程碑”,创建一次交付,例如
v0.2。 - 填写目标说明和适合的截止日期,保存后将相关事项分配进去。
- 查看开放与已关闭事项,及时拆出不在范围内的工作。
- 达到团队约定的验收条件后关闭里程碑,并在版本发布中写明最终交付内容。
里程碑完成比例反映所含事项的状态,不直接代表测试覆盖率或实际工时。关闭里程碑不会自动发布软件,也不会替你决定未关闭事项应该转到哪个版本。
区分关闭项目与删除项目
关闭项目适合保留阶段工作记录,之后按权限可重新打开。删除项目会移除该看板的组织信息,执行前应核对名称及页面确认提示。项目删除不等同于删除代码仓库,相关事项的保留情况以确认说明和实际结果为准。
长期项目建议定期整理完成的卡片与过期任务。不要为了让数字好看而关闭仍需处理的议题;将任务拆分成能验证的结果,会比堆积宽泛卡片更有帮助。