什么是工作项?¶
工作项(Issue)是 Specivo 中的基本工作单元。每个待修复的缺陷、待开发的功能、待完成的任务或待解答的问题,都对应一个工作项,有自己的页面、编号和历史记录。工作项属于某个项目,并按项目编号:ACME 项目的第一个工作项是 ACME-1,下一个是 ACME-2,依此类推。把 ACME-42 粘贴到聊天或提交信息里,所有人都能确切知道你指的是哪个工作项。管理员可以重命名项目标识;工作项会随之换用新编号,旧引用(链接、文本中的 OLD-12、提交信息)依然有效,并指向新标识下的同一工作项。

追踪器:四种工作项类型¶
追踪器(Tracker)即工作项的类型。Specivo 默认提供四种:
| 追踪器 | 用途 | 显示在路线图上? |
|---|---|---|
| Bug(缺陷) | 某处出了问题,需要修复 | 是 |
| Feature(功能) | 新功能或增强 | 是 |
| Task(任务) | 既不是缺陷也不是功能的一般性工作 | 是 |
| Support(支持) | 用户提出的问题或请求 | 否 |
Bug、Feature 和 Task 会显示在路线图上,Support 工作项则不会,这样日常请求就不会干扰你的发布规划。
工作项的字段¶
创建工作项时只有两个字段必填:主题 和 追踪器。其余字段都是可选的,可以之后再填。
| 字段 | 内容 |
|---|---|
| 主题 | 简短清晰的标题(最多 1024 个字符),必填 |
| 描述 | 完整说明,Markdown 格式,支持 @username 提及 |
| 追踪器 | Bug、Feature、Task 或 Support,必填 |
| 状态 | 工作项在生命周期中所处的阶段,例如 New(新建)、In Progress(进行中)等 |
| 优先级 | Low(低)、Normal(普通)、High(高)、Urgent(紧急)或 Immediate(立即) |
| 负责人 | 负责这项工作的人 |
| 类别 | 项目范围内的标签,例如“后端”或“前端” |
| 目标版本 | 该工作项所针对的版本(里程碑/发布) |
| 冲刺 | 该工作项被排入的冲刺(Sprint) |
| 开始日期 / 截止日期 | 工作应开始和结束的时间 |
| 预计工时 | 预计小时数,另含原始预计(最初计划的工时)和剩余预计(尚需投入的工时) |
| 完成百分比 | 从 0 到 100 的进度 |
| 父工作项 | 使该工作项成为另一个工作项的子工作项 |
| 私有 | 除作者、负责人和管理员外,其他人都看不到该工作项 |
| 关注者 | 即使不是负责人也会收到变更通知的人,前提是他们能看到该工作项 |
| 元数据 | 核心字段之外的结构化类型字段,见下文 |
元数据 是额外的类型化数据(故事点、git 分支、严重级别),由可复用的架构定义,因此同样的字段在不同工作项之间保持一致。参见工作项元数据。