Jira 迁移验收清单要能直接判定通过与否，核心是六列结构：检查项、通过标准、证据、负责人、检查时点、是否阻断。范围先写清覆盖哪些项目、问题类型、字段、附件、权限和集成，再按迁移前基线、试迁移、正式切换后三个时点分阶段核对。数据缺失或错位、权限越权、关键集成中断、无可用回退方案应列为阻断项，清零后才能签署验收。
要点总览（TL;DR）
- 清单采用六列结构：检查项、通过标准、证据、负责人、检查时点、是否阻断，每一项都能直接判定通过或不通过。
- 验收分三个时点：迁移前基线确认、试迁移验收、正式切换后验收；试迁移与正式切换使用同一套检查项，样本范围不同。
- 数据完整性用数量比对加分层抽样：先核对问题、评论、附件、链接关系总数与基线一致，再按项目与问题类型抽样逐字段比对。
- 阻断项限定为四类：数据缺失或错位、权限越权或敏感数据暴露、关键集成中断、无可用回退方案；其余问题登记为非阻断项并设修复时限。
- 证据以可复核为原则，导出报表、比对截图、抽样清单和签署记录统一存放并规范命名，便于事后复查。
谁在什么时点使用这份验收清单
验收清单在迁移启动时就要确定使用人和时点，避免到切换当天才发现没人能判定某项是否通过。建议在清单首页固定一张“范围与角色时点表”，后续所有检查项都挂在这张表下。
| 要素 | 需要写清的内容 | 示例填写方式 |
|---|---|---|
| 验收责任人 | 迁移负责人（总体判定）、Jira 管理员（数据与配置）、业务/项目代表（可用性）、安全与运维（权限、集成、回退） | 每类检查项指定一名主责人和一名复核人 |
| 时点一：迁移前基线确认 | 冻结并留存可比对的数据与配置快照 | 切换前 T-5 个工作日完成，负责人签字 |
| 时点二：试迁移验收 | 用全量或高代表性样本跑一遍完整检查项 | 试迁移环境完成后 2 个工作日内 |
| 时点三：正式切换后验收 | 按同一套检查项核对正式环境，样本范围扩大到全量 | 切换后首个工作日完成阻断项，3 个工作日内完成全部 |
| 范围声明 | 项目清单、问题类型、自定义字段、附件、用户与组、权限方案、集成与自动化规则 | 逐项列出名称或编号，注明“不在本次范围”的对象 |
范围声明要具体到对象名称。写“迁移全部项目”不如列出项目键和负责人；写“迁移权限”不如列出权限方案名称和涉及的用户组。范围越具体，验收时争议越少。
迁移前基线：先固定可比对的口径
验收的本质是比对，比对的前提是有一份迁移前留存的基线。基线快照应在停止 Jira 写入或进入切换窗口前完成，并由迁移负责人确认后锁定，之后不再修改。
- 数量基线：按项目导出问题数、评论数、附件数（含附件总容量）、问题链接关系数、子任务数，以及用户与用户组清单。
- 字典基线：记录问题类型、状态、优先级、分辨率、自定义字段（字段名、类型、选项值）的完整清单，枚举字段要记录全部取值。
- 配置基线：记录工作流名称与状态流转关系、字段配置方案、权限方案、通知方案。
- 集成与自动化基线：列出代码仓库关联、CI 触发、IM 通知、单点登录、Webhook、自动化规则及其触发条件。
- 留存方式：基线文件统一存放在指定目录，命名包含日期与版本号，明确保管人；导出报表与截图同时保留，便于事后复核。
基线中的每一项都应在验收清单里有对应的核对项。基线没记录的内容，验收阶段就无法判断是否丢失，因此宁可多记，不要漏记。
数据完整性检查项与通过标准
数据完整性检查分两层：先做总量比对，再做分层抽样逐字段比对。总量比对发现差异时立即定位，抽样比对用于发现数量一致但内容错位的情况。
| 检查项 | 通过标准 | 证据 | 负责人 | 时点 | 阻断 |
|---|---|---|---|---|---|
| 问题总数 | 与基线逐项目一致，差异为 0 或有书面说明并获批 | 迁移前后数量对照表 | Jira 管理员 | 试迁移、正式 | 是 |
| 评论与附件数量 | 评论数、附件数及附件总容量与基线一致 | 导出报表、容量对比截图 | Jira 管理员 | 试迁移、正式 | 是 |
| 链接关系 | 问题链接、父子任务关系数量一致，抽查关系指向正确 | 关系清单比对结果 | Jira 管理员 | 试迁移、正式 | 是 |
| 字段值完整性 | 关键字段非空率与基线偏差在约定阈值内，无截断、乱码 | 字段非空率统计、抽样截图 | 业务代表 | 试迁移、正式 | 是（关键字段） |
| 时间戳与作者 | 创建时间、更新时间、评论作者按迁移前确认的口径保留 | 抽样问题详情截图 | Jira 管理员 | 试迁移、正式 | 是 |
| 原始编号 | 原 Jira 问题键可追溯，或在目标系统中保留映射关系 | 编号映射表 | Jira 管理员 | 试迁移、正式 | 是 |
| 分层抽样比对 | 按项目与问题类型分层抽取样本，逐字段比对无差异 | 抽样清单与比对记录 | 业务代表 + 管理员 | 试迁移、正式 | 是 |
抽样比例由企业按数据规模确定，建议覆盖每个项目、每种问题类型和每种自定义字段类型，并包含附件较多、评论较多、状态流转复杂的问题各若干条。抽样清单本身要作为证据留存，注明抽样规则和抽取人。
字段、状态与工作流映射检查项
映射检查的依据是迁移前确认的映射方案，验收时逐项核对实际结果是否与方案一致。未映射项必须有明确处置结论，不能以“后续再看”通过验收。
| 检查项 | 通过标准 | 证据 | 负责人 | 阻断 |
|---|---|---|---|---|
| 自定义字段映射 | 映射方案中每个字段在目标系统存在且类型匹配，逐项打勾 | 字段映射核对表 | Jira 管理员 | 是（关键字段） |
| 未映射字段处置 | 每个未映射项有书面结论：合并、弃用或保留原值说明 | 未映射项处置记录 | 迁移负责人 | 否 |
| 状态与工作流 | 状态映射后流转路径可用，关键流转实际操作一遍无报错 | 流转测试截图 | 业务代表 | 是 |
| 问题类型与优先级 | 字典项一一对应，无默认值兜底导致的错误归类 | 字典对照表 | Jira 管理员 | 是 |
| 枚举与多选字段 | 全部取值完整迁移，多选字段选项数量与基线一致 | 取值清单比对 | Jira 管理员 | 是 |
工作流检查不能只看配置界面，要让业务代表用真实问题走一遍典型流转，包括退回、重新打开等非常规路径。流转中依赖的条件、校验器和后置动作也要一并确认。
权限、可见性与通知检查项
权限问题的影响面最大，验收时以迁移前基线为唯一对照口径，逐项目核对，并对敏感项目做定向抽查。
- 项目与问题级权限：对照基线核对每个项目的浏览、创建、编辑、流转、删除权限授予对象，差异项逐条说明。
- 敏感范围抽查：选取受限项目或安全级别问题，用不同角色账号实际访问，确认无越权可见、无该隐藏却公开的情况。
- 通知与订阅：核对通知方案是否生效，关键用户确认能收到指派、评论、状态变更通知，且无重复轰炸。
- 外部共享与公开链接：确认迁移前存在的外部共享链接、公开看板、匿名访问入口已按计划关闭或重新配置。
权限越权或敏感数据暴露属于阻断项，发现即停止验收推进，修复后重新抽查。通知异常一般列为非阻断项，但要在切换后首个工作日内修复。
集成、自动化与用户可用性检查项
系统连通和真实使用是两件事，验收要分别覆盖。集成检查确认技术链路通，可用性检查确认关键用户能按角色完成日常工作。
| 检查项 | 通过标准 | 证据 | 负责人 | 阻断 |
|---|---|---|---|---|
| 代码仓库与 CI 集成 | 提交关联问题、构建状态回写正常 | 联调记录截图 | 运维 | 是 |
| IM 与单点登录 | 通知可达、SSO 登录成功且角色正确 | 登录与消息截图 | 运维 | 是 |
| 自动化规则 | 迁移后规则触发条件与执行结果符合预期，逐条核对 | 规则清单与触发日志 | Jira 管理员 | 是（关键规则） |
| 角色实操验证 | 项目经理、开发、测试各完成一轮建单、流转、评论、查报表 | 实操记录与反馈单 | 业务代表 | 是 |
| 问题反馈闭环 | 验收期发现的问题全部登记，有责任人和修复时限，关闭有复核 | 问题登记表 | 迁移负责人 | 否 |
依赖 Jira 插件的功能要单独列项。插件能力在目标系统中往往需要重新匹配，验收时应按实际使用清单逐项确认替代方案是否满足业务需要，定制场景逐项评估，不能默认一一对应。
验收过程中产生的问题单、比对记录和签署材料需要有统一的承载位置。ONES 的工作项与文档能力可用于登记验收问题、关联证据并跟踪关闭状态，使验收记录与迁移任务在同一处可查；具体使用方式按团队现有流程配置。
阻断项与完成条件
阻断项是验收的硬门槛，未清零不得签署通过。建议将阻断项限定为四类，其余问题登记为非阻断项并设修复时限。
- 数据缺失或错位：问题、评论、附件、链接关系数量与基线不符且无获批说明，或抽样发现字段内容错位。
- 权限越权或敏感数据暴露：受限内容被无权限用户可见，或公开入口未按计划处置。
- 关键集成中断：代码仓库、CI、单点登录等关键链路不可用，导致研发流程无法运转。
- 无可用回退方案：回退触发条件未定义，或回退演练未通过。
非阻断项要登记问题描述、影响范围、责任人、修复时限和复核人，在约定时限内关闭。验收结论由迁移负责人汇总，业务代表与安全运维分别就各自负责的检查项签署意见，全部阻断项清零且非阻断项均有明确处置计划，方可判定通过。
回退方案要在正式切换前完成演练并记录结果，明确触发条件（如阻断项在约定时限内无法修复）、回退操作步骤、数据回补方式和决策人。回退演练记录作为验收证据留存。
证据留存与收尾归档
验收结论要有可复核的证据支撑，证据管理规则应在清单中提前写明，避免事后补材料。
- 证据类型：数量对照报表、字段非空率统计、抽样比对记录、权限抽查截图、集成联调截图、实操反馈单、问题登记表、签署记录、回退演练记录。
- 存放与命名：统一目录存放，文件名包含检查项编号、时点与版本，例如“S3-问题总数-正式-20250101”。
- 旧系统处置：明确 Jira 转为只读或下线的时点、保留期限和通知范围，通知到所有原 Jira 用户。
- 归档与复查：验收记录归档后约定复查节点，例如切换后一个月复查数据使用情况和遗留问题关闭情况。
把以上内容组织成一张总表，每行一个检查项，六列信息齐全，阻断项单独标记，这份清单就可以直接用于试迁移和正式切换两轮验收。阈值、抽样比例和时间窗口由企业按自身数据规模在迁移启动会上确定，并写入清单首页。
常见问题
试迁移验收和正式切换后验收，检查项要重新设计吗？
不需要重新设计。两轮验收使用同一套检查项和同一份基线，区别在于样本范围：试迁移阶段可以用全量或高代表性样本跑一遍，重点验证迁移方案和映射规则是否成立；正式切换后把样本范围扩大到全量，确认正式环境的结果与试迁移一致。
如果试迁移阶段调整了映射方案或迁移脚本，基线本身不变，但要在清单中记录调整内容和重新验证的检查项，避免正式验收时沿用旧结论。
迁移前基线应该在什么时点锁定？锁定后还能改吗？
基线应在停止 Jira 写入或进入切换窗口前完成，由迁移负责人确认后锁定。锁定后不再修改，后续所有比对都以这份快照为准。
如果切换窗口内仍有新问题或评论产生，需要单独记录这部分增量数据，并在验收时说明其处理方式，不能直接并入基线，否则数量比对会失去可比口径。
抽样比对抽多少、怎么抽才算有效？
抽样比例由企业按数据规模确定，没有统一数值。有效的抽样要覆盖每个项目、每种问题类型和每种自定义字段类型，并包含附件较多、评论较多、状态流转复杂的问题各若干条。
抽样清单本身要作为证据留存，注明抽样规则、抽取人和抽取时间。只抽一两个项目或只抽正常流转的问题，容易漏掉字段截断、关系指向错误这类问题。
发现阻断项后，验收流程怎么走？
阻断项发现即停止验收推进，登记问题描述、影响范围、责任人和修复时限，修复后重新执行对应检查项并重新抽查，确认清零后才能继续。
如果阻断项在约定时限内无法修复，按回退方案处理。回退触发条件、操作步骤和决策人应在正式切换前写入清单，并完成一次回退演练。
依赖 Jira 插件的功能，验收时怎么处理？
插件功能要单独列项，不能默认一一对应。验收前先梳理实际使用的插件清单，再逐项确认目标系统中的替代方案是否满足业务需要，定制场景逐项评估。
ONES 的迁移方案也提示，依赖 Jira 或 Confluence 插件的功能需要先梳理实际使用情况，再通过 ONES Project、Wiki、TestCase、流程自动化和开放能力做功能匹配，企业已有的定制场景在迁移前仍需逐项评估。
