Jira 上手记录：概念、建项目、工作流与权限

Jira 用不起来，多半不是功能不够，而是每个人对「问题」「项目」「工作流」这几个词理解不一致。这篇按自己的顺序理一遍：对齐概念、建项目、配工作流和人、收权限。

一、先把三个概念对齐

角色

角色按职责划分：系统管理员管实例配置、用户、插件；项目管理员管本项目的权限、工作流、通知；开发处理分派给自己的问题并记工时；测试录缺陷、验证修复；业务分析员和项目经理提需求看进度。另有几个偏「动作」的：报告者（Reporter）、关注者（Watcher）、投票者（Voter）、审批者（Approver）。

问题（Issue）

Issue 是 Jira 唯一的核心对象。缺陷、任务、技术难题、报销审批都是 Issue，字段固定：类型、摘要、描述、项目、组件、影响版本、修复版本、环境、优先级、报告者、经办人、状态、历史。

默认类型四种：Bug、New Feature、Task、Improvement。优先级五级：紧急、严重、一般、次要、无关紧要。状态走 Open → In Progress → Resolved → Reopened → Closed，Resolved 与 Reopened 的差别只在结论有没有被认可。关闭时还要选解决方式：Fixed、Won’t Fix、Duplicate、Incomplete、Cannot Reproduce。最后这个要盯住，信息不足就退回补齐，否则缺陷统计失真。

项目

项目就是一堆 Issue 的集合，关键字决定 Issue 编号前缀（DEVOPS → DEVOPS-1）。项目层面还有版本（影响版本／修复版本，分已发布、未发布、已归档，到期未发布标超期）和组件（项目内逻辑分类，可挂多个也可不挂）。Administer Projects 一般给负责人，拿到它管不了系统，只管自己项目的版本和组件。

二、把一个项目建起来

浏览器打开 http://192.168.66.15:8080/secure/Dashboard.jspa，管理员账号登录。

新实例里没有项目，第一件事就是建。类型选 Scrum 软件开发，自带 Scrum 板、基本敏捷工作流和任务类型，都能再改。

填名称、关键字、负责人，提交后进 Backlog。

组件在项目详情页创建，填模块信息和经办人；版本点「创建版本」维护。

这里有个坑：项目 Key 建好之后改不了，想换只能重建再迁数据，关键字一开始就要定规范。再建项目走顶部「项目 → 创建项目」。

任务多了用 Sprint（冲刺）分组，项目详情页点创建 Sprint。

项目多了用项目类别（Project Categories）归类，列表和报表都清爽。

三、通知、权限和工作流

项目配置是「方案（Scheme）」化的，一套方案能被多个项目复用，这也是它难懂的地方。权限分系统级、项目级、Issue 级、评论级：系统级走全局权限（Global Permissions），影响所有项目；项目级再靠权限方案往下收。

通知方案在「设置 → 问题」里新增，管的是「什么事件、通知谁、走什么渠道」，别给每个项目单开一套。

工作流决定 Issue 在状态之间怎么跳：矩形框是状态，箭头是跳转。入口在项目详情页的工作流菜单。

选中流程点编辑进设计器：

加状态即加节点：

加转换即加连线，指定开始与目标状态：

连线上可挂条件、校验器、后置动作，限制谁能点这个按钮、跳转前必须填哪些字段：

改完必须发布。动正在使用的流程前先在测试项目验证一轮，工作流改坏会让存量 Issue 卡在没人能推进的状态。

四、人：用户与组

装完只有一个管理员账号，加人在「设置 → 用户管理」里点创建用户。

用户名不要用汉字，用拼音或工号，否则后面集成 AD/LDAP、脚本调 API 都会别扭。

授权走组不走个人：给组赋权，人进来加组、走了退组，权限模型才不会被几十个零散授权拖垮。

提一个 Issue 走完全流程

选中项目打开创建对话框：

第二步填项目、概要、优先级和描述：

建好后分派给人：

被分派的人在「分派给我的」里点开，可操作项由工作流决定——下图这个状态下有三个：开始进行、解决问题、关闭问题。

此外还能上传附件、加备注、复制编辑，有权限可以删除、建子任务。

五、几条结论

• 项目 Key 不可改，先定命名规范；权限授给组不授给人。
• Issue 类型、状态、工作流够用就停，别把每个团队的特殊流程塞进全局方案。
• 修复版本留空会被归到「未规划」，发版前要有报表盯这批遗漏。
• 术语对齐：Sprint 是一个迭代周期（常见 2~4 周），Sprint Backlog 是本次迭代任务清单，Product Backlog 是按价值排序的需求列表。