JIRA 快速参考
工单、JQL、工作流、看板、Sprint、过滤器
工单（Issues）
工单类型
| Epic | 大型工作体；包含多个 Story |
| Story | 面向用户的功能或需求 |
| Task | 工作单元（技术性或非技术性） |
| Bug | 缺陷或异常行为 |
| Sub-task | Story/Task 的子任务；不能单独存在 |
工单字段
| Summary | 简短标题（必填） |
| Description | 详细说明、验收标准 |
| Assignee | 负责人 |
| Priority | 最高 / 高 / 中 / 低 / 最低 |
| Labels | 自由格式标签，用于分组 |
| Components | 项目子模块（如 Backend、UI） |
| Fix Version | 此工单对应的发布版本 |
| Story Points | 工作量估算（Scrum） |
工单关联
| blocks / is blocked by | 依赖关系 |
| clones / is cloned by | 重复工单追踪 |
| relates to | 一般性关联 |
| is caused by / causes | 根因关联 |
JQL 搜索
基本语法
project = MYPROJ AND status = "In Progress"
assignee = currentUser() AND resolution = Unresolved
priority in (High, Highest) ORDER BY created DESC
运算符
| = | 精确匹配 |
| != | 不等于 |
| in (a, b) | 匹配列表中任意值 |
| not in (a, b) | 排除列表 |
| ~ "text" | 包含（文本搜索） |
| !~ "text" | 不包含 |
| is EMPTY | 字段无值 |
| is not EMPTY | 字段有值 |
| > < >= <= | 比较（日期、数值） |
日期函数
created >= -7d # last 7 days
due <= endOfWeek() # due this week
updated >= startOfMonth() # updated this month
created >= "2025-01-01" # since specific date
常用 JQL 模式
# Stale issues
status != Done AND updated <= -30d
# My open bugs
assignee = currentUser() AND type = Bug AND resolution = Unresolved
# Sprint scope
sprint in openSprints() AND project = MYPROJ
工作流
默认工作流
| To Do | 尚未开始 |
| In Progress | 进行中 |
| Done | 已完成 |
扩展工作流
| Open | 已创建，等待分诊 |
| In Progress | 积极处理中 |
| In Review | 代码评审或 QA |
| Done | 已验收并关闭 |
| Reopened | 从 Done 状态重新打开 |
工作流概念
| Status | 工单的当前状态 |
| Transition | 状态之间的允许转换 |
| Condition | 谁可以执行转换 |
| Validator | 转换执行前的校验 |
| Post Function | 转换后的自动动作（如指派） |
| Resolution | 工单关闭原因（已修复、不修复等） |
看板
看板类型
| Scrum Board | 基于 Sprint；含 backlog、Sprint 计划、velocity |
| Kanban Board | 持续流；WIP 限制，无 Sprint |
看板列
| Column | 对应一个或多个状态 |
| WIP Limit | 列中最大工单数（Kanban） |
| Swimlane | 水平分组（按 Epic、负责人等） |
| Quick Filter | 基于 JQL 的看板切换过滤器 |
看板配置
| Filter | 定义看板范围的 JQL 查询 |
| Estimation | Story Points 或原始估算 |
| Card Layout | 工单卡片上显示的字段 |
| Card Colors | 按优先级、负责人或查询着色 |
Sprint
Sprint 生命周期
| Create | 命名 + 可选目标和日期 |
| Plan | 从 backlog 拖拽工单到 Sprint |
| Start | 设置持续时间（通常 1-4 周） |
| Active | 团队处理 Sprint 工单 |
| Complete | 未完成的工单移到 backlog 或下一 Sprint |
Sprint 报表
| Burndown Chart | 剩余工作量与时间的关系 |
| Sprint Report | 已完成与未完成的对比 |
| Velocity Chart | 每个 Sprint 的 Story Points 趋势 |
| Cumulative Flow | 状态分布随时间的变化 |
Sprint JQL
sprint in openSprints() # current sprint
sprint in futureSprints() # upcoming sprints
sprint = "Sprint 12" # specific sprint
sprint in closedSprints() AND resolution = Unresolved
过滤器
创建过滤器
| Search | 在工单搜索中编写 JQL |
| Save As | 将 JQL 另存为命名过滤器 |
| Star | 收藏过滤器以便快速访问 |
| Subscription | 按计划将过滤结果发送到邮箱 |
共享与权限
| Private | 仅自己可见 |
| Group | 与指定群组共享 |
| Project | 与项目成员共享 |
| Public | 所有登录用户均可见 |
| Edit Permissions | 控制谁可以修改过滤器 |
仪表板
| Filter Results | 显示过滤器工单的小部件 |
| Pie Chart | 按字段分类（优先级、负责人） |
| Two Dimensional | X/Y 矩阵（如优先级 vs 状态） |
| Activity Stream | 项目近期活动 |
快捷键
全局导航
| g then d | 跳转到仪表板 |
| g then b | 跳转到看板 |
| g then i | 跳转到工单搜索 |
| / | 快速搜索 |
| c | 创建工单 |
| ? | 显示键盘快捷键 |
工单视图
| a | 指派给自己 |
| m | 评论 |
| l | 编辑标签 |
| e | 编辑工单 |
| j / k | 列表中下一个 / 上一个工单 |
| o | 打开选中的工单 |
看板快捷键
| 1-9 | 将工单移到第 1-9 列 |
| t | 切换详情视图 |
| n | 下一张卡片 |
| p | 上一张卡片 |
常见模式
Bug 报告模板
| Summary | [组件] Bug 的简短描述 |
| Steps to Reproduce | 触发问题的操作步骤（编号） |
| Expected | 预期行为 |
| Actual | 实际行为 |
| Environment | 操作系统、浏览器、版本等 |
| Severity | 阻塞 / 严重 / 重大 / 次要 / 微小 |
Story 格式
As a [role],
I want [action],
so that [benefit].
---
Acceptance Criteria:
- [ ] Criterion 1
- [ ] Criterion 2
批量操作
| Search → Select All | 从搜索结果中选择工单 |
| Bulk Change | 批量编辑、转换状态或删除 |
| CSV Export | 导出搜索结果用于报表 |
| Board drag | 在列/Sprint 之间拖拽工单 |