2. 问题类型与字段配置：定义标准问题类型、自定义字段、字段配置方案

适用场景

• 团队初次建立Jira项目，需要规划与业务匹配的问题类型体系（如故事、缺陷、任务、改进等）。
• 标准Jira字段不满足业务信息记录需求（如“上线版本”、“测试环境”、“优先级权重”），需要添加自定义字段。
• 不同工作流或用户角色希望看到不同的字段组合，需要创建字段配置方案实现字段按场景展示/隐藏。
• 敏捷/看板/自定义工作流项目初始化时，必须完成问题类型与字段配置，否则后续流程无法准确追踪数据。

前置条件

1. 已拥有 Jira 项目管理员权限（Project Admin 或 Jira Admin）。
2. 已在 Jira 中创建了目标项目（建议使用空白项目或基于模板创建后清理）。
3. 已明确团队需要记录的关键维度（例如：缺陷影响范围、需求提出人、开发环境、验收人）。
4. 已规划好问题类型映射表：业务概念 ↔ Jira 问题类型名称。

操作步骤

步骤一：定义标准问题类型（Issue Type）

1. 登录 Jira，进入齿轮图标 ⚙️ → Issues → Issue types。
2. 若需新建问题类型，点击 Add issue type，输入名称（如“技术债务”）、描述，选择类型（Standard / Sub-task）。
3. 在项目设置中，进入 Project settings → Issue types，将所需的问题类型关联到当前项目。
4. 建议至少保留：Story、Task、Bug、Epic、Sub-task。

步骤二：创建自定义字段（Custom Field）

1. 进入 ⚙️ → Issues → Custom fields，点击 Add custom field。
2. 选择字段类型（如文本框、单选列表、多选列表、日期选择器、数值、URL、用户选择器等）。
3. 填写字段名称、描述，并设定选项值（若为选项型字段）。
4. 配置字段的 适用上下文（Context）：选择项目、问题类型，也可以限制仅特定发布版本或用户组可见。
5. 保存后，字段默认添加到所选项目的默认字段配置中。

步骤三：配置字段配置方案（Field Configuration Scheme）

1. 进入 ⚙️ → Issues → Field configurations。
   • 点击 Add field configuration，命名（如“缺陷默认配置”、“需求详细配置”）。
2. 在新的字段配置中，可以为每个字段设置：
   • Required / Optional（必填/可选）
   • Hidden / Default value / Renderer
   • 描述文本、占位符、验证规则
3. 创建或编辑 Field configuration scheme：
   进入 ⚙️ → Issues → Field configuration schemes → Add scheme。
   • 为每种问题类型绑定一个字段配置。例如：

     问题类型	绑定字段配置
     Bug	缺陷必填配置（含“严重程度”、“复现步骤”字段）
     Story	需求详细配置（含“验收标准”、“业务价值”）
     Task	精简配置（仅标题、描述、经办人）

4. 将配置方案关联到项目：
   进入项目设置 Project settings → Fields，在“Field Configuration Scheme”下拉中选择已创建的方案，点击 Apply。

输入输出物

输入物	输出物
团队业务字段需求清单	标准问题类型列表（新增/调整后）
Jira 后台管理员账号	自定义字段定义（含选项值、上下文）
项目名称与问题类型映射表	字段配置方案（按问题类型绑定字段配置）
权限确认（项目管理员）	项目已应用新字段配置方案

责任边界

• Jira 管理员（Jira Admin）：创建全局自定义字段、问题类型、字段配置方案，维护方案至项目。拥有最高修改权限。
• 项目管理员（Project Admin）：在项目范围内选择字段配置方案，并在项目设置中分配问题类型。不能修改全局字段选项，但可以自定义字段的上下文。
• 团队 Leader / PM：提供字段需求清单、问题类型映射规则，确认字段必填/可选策略。
• 普通成员：无配置权限，但可在创建/编辑问题时使用配置好的字段填写数据。

记录材料

• 问题类型清单（Excel / Confluence 页面）：列出所有问题类型名称、类型（标准/子任务）、使用场景说明。
• 自定义字段定义表：字段名称、类型、选项值列表、适用项目与问题类型、是否必填。
• 字段配置方案映射矩阵：问题类型 → 字段配置名 → 字段列表与可见性规则。
• 变更日志：记录字段添加/修改时间、操作人、原因。

异常处理

异常现象	原因	解决方案
自定义字段在问题创建页面不显示	字段未添加到字段配置，或上下文未包含该问题类型	检查字段上下文：进入自定义字段 → 点击“Configure” → 添加该项目与问题类型
修改字段配置后，已有问题中字段未生效	字段配置仅对新创建问题生效（默认行为）	手动批量更新已有问题（通过 Jira 批量操作或脚本），或修改字段配置中的“Default value”不会影响已有值
删除字段后，历史问题仍显示该字段（空值）	删除字段不会从历史数据中移除，但字段消失	无影响；若需彻底清除，需联系 Jira Admin 用数据库工具清理（危险操作，慎用）
字段配置方案无法应用到项目	项目已存在冲突的字段配置方案（如通过项目模板继承）	先解除项目原有方案关联：进入项目设置 → Fields → 点击“Use a different scheme”选择新方案

验收标准

1. 项目中已存在规划的所有问题类型，且每个问题类型可以正常创建。
2. 自定义字段（如“严重程度”、“验收标准”）在对应的创建/编辑页面正确显示，且必填/可选状态符合预设。
3. 不同问题类型看到的字段集合不同（例如：Bug 显示“复现步骤”，Story 不显示）。
4. 字段配置方案已应用到项目，且在项目设置 → Fields 中显示为“Active”。
5. 随意创建一个测试问题，填写所有必填字段，保存后字段值正确存入。
6. 所有配置变更已记录在 记录材料 中，且团队理解如何使用新字段。