Jiraの「課題移動（Move）」でナレッジを殺すな：カスタムフィールド消失を防ぐ「外科手術」の極意
プロジェクトの統合や分割は、組織の成長に伴う通過儀礼だ。しかし、Jiraの「課題の移行（Move）」は、現場のエンジニアにとって最も胃が痛くなる作業の一つである。何も考えずに「次へ」を連打すれば、積み上げたカスタムフィールドのデータは霧散し、履歴は分断され、チームのコンテキスト（文脈）は崩壊する。
今日は、Jiraの仕様の裏側を突き、「データの整合性を1ビットも損なわずに安全に課題を移行する」ための、テックリード直伝の外科手術の手順を伝授する。
—
1. 移行ウィザードの「最大の落とし穴」を回避せよ
Jiraの移行ウィザードは、ターゲットプロジェクトに同名のフィールドが存在しない場合、容赦なくデータを切り捨てる。これを防ぐための鉄則は「マッピングの事前準備」だ。
移行前のチェックリスト
1. コンテキスト（Context）の確認:
カスタムフィールドが「グローバル」設定になっているか、「特定プロジェクト限定」になっているかを確認せよ。ターゲットプロジェクトに紐付いていないフィールドは、移動先で「存在しない」とみなされる。
2. スキーマの同期:
移行前に、移行先プロジェクトの「フィールド設定」に、移行元と同じ名前・同じデータ型のフィールドを必ず作成しておくこと。
3. 「選択リスト」の選択肢一致:
これが一番の罠だ。選択リスト（ドロップダウン）の場合、選択肢のIDが違えば移行後に値が空になる。必ず移行元と移行先で「選択肢のラベル」だけでなく「ID（または正確な文字列）」を揃えろ。
—
2. 実務で差がつく！「神」の運用テクニック
開発スピードを爆速にするキーボードショートカット
Jiraの画面遷移でマウスに触れるのは負けだ。以下のショートカットを体に叩き込め。
- `g` + `i`: 課題検索へ即座にジャンプ。
- `.` (ドット): コマンドパレットの呼び出し。ここから「Move」と打てば、画面をクリックして回る必要はない。
- `w`: 課題のウォッチ/解除。
- `m`: コメント入力欄へ即座にフォーカス。
チーム開発の生産性を底上げする「神プラグイン」
- ScriptRunner for Jira: これなしでJiraを使うのは、素手で岩を砕くようなものだ。複雑な移行後のデータクリーンアップや、自動転記のスクリプトはこれで書け。
- Jira Misc Workflow Extensions (JMWE): 移行後のステータス更新時に、特定のカスタムフィールドを自動で埋める「後処理（Post-function）」を構築する際に必須。
—
3. 自動化のための「設定コード」管理（ベストプラクティス）
Jiraの設定をGUIでポチポチするのはやめろ。大規模な移行を行う際は、設定をJSON/XMLでエクスポートし、チームで共有せよ。
以下は、フィールドの設定を管理するためのJSON構成例だ。これをGitで管理し、チームの「Jira構成リポジトリ」として運用せよ。
{
“field_configuration”: {
“name”: “Engineering-Core-Fields”,
“fields”: [
{
“id”: “customfield_10101”,
“name”: “Technical-Debt-Score”,
“type”: “com.atlassian.jira.plugin.system.customfieldtypes:float”,
“description”: “技術的負債の概算値（移行時必須）”
}
]
}
}
—
4. リンクと添付ファイルの「死角」を塞ぐ
移行ウィザードは、課題自体の移動には強いが、「外部連携」や「歴史的背景」には脆い。
- リンク関係の継承: 課題を移動させても、Jira内の課題リンク（Issue Link）は自動で追従する。しかし、Confluenceページや外部Wikiへの参照はリンク切れを起こす可能性がある。移行前に、重要なドキュメントとのリンク一覧をエクスポートしておけ。
- 添付ファイルの保存場所: 添付ファイルはデータベースではなくファイルサーバー（またはS3）にある。移動後にインデックスの再構築（Re-indexing）を必ず行い、メタデータの齟齬を解消せよ。
—
5. 最後に：テックリードからの提言
プロジェクトの移行とは、単なる「場所の移動」ではない。チームの記憶の再編だ。
もしあなたが今、複雑なプロジェクト統合を任されているなら、「10件程度のテスト課題で、一度完全な移行シミュレーションを行え」。移行先の環境でカスタムフィールドの値が正しく表示され、検索クエリ（JQL）で正しくヒットすることを確認してから、本番のバルク操作に入る。
Jiraは使いこなせば最強のパートナーだが、放置すればただの負債製造機になる。ツールを操るのではなく、ツールに「チームの文化」を刻み込め。
さあ、次のスプリントに向けて、無駄のない最強のバックログを構築しよう。