项目状态配置
项目状态定义这组工作如何表示进度。改一个状态的分组,可能影响已结束筛选、完成时间和归档判断。
合同说明,设置操作未核验
本页依据固定状态与生命周期文档。状态原文存在新旧语义混杂:本指南采用较新合同的唯一 Issue.state,不采用旧独立阶段轴说法。未编辑、排序或删除状态。
名称、状态组和语义分别是什么
| 信息 | 如何理解 |
|---|---|
| 名称与颜色 | 方便人识别,不能仅靠名称或颜色判断业务权限 |
| 状态组 group | 决定未结束、完成或取消等原生生命周期范围 |
| progress_role | 原生状态的业务语义,例如执行中、专业验收、测试 |
| 默认状态 | 新工作项使用的项目默认配置之一,不能据此推断所有类型都能直接进入 |
“看起来像 Done”的名称不一定就是完成状态组。反过来,当前环节的提示也不能替代原生状态。
配置前先核对
- 在正确项目的设置中查看状态入口,确认自己是否有管理权限。
- 明确要改的是显示名称、默认值、顺序,还是状态组及业务语义。
- 查看已有工作项和验收流程是否依赖该状态。
- 保存后核对实际结果;遇到冲突时刷新当前配置,不用重复操作覆盖他人的修改。
源文档指出 Web 与 API 状态管理权限仍有差异,不能只根据前端隐藏按钮推断服务端行为。
删除状态的边界
源文档记录当前 UI/API 对默认状态、仍有工作项的状态等存在删除限制;“分组最后一个状态”的客户端保护与服务端完整收敛仍需核验。
不要把所有限制写成已经统一验证的系统保证,也不要先清空工作或改写业务状态来尝试删除。先确认影响和替代状态。
状态配置不替代业务动作
Task 或 Bug 的执行、验收、打回和关闭应遵守适用业务动作与权限。看板拖动、批量操作或状态下拉不应成为跳过证据和人类验收的路径。