← ガイド · English · Português · 中文

更新 2026-11-20

このページの目次
  1. 公式プレイブック
  2. ステップ 1 — 移行が適格か確認する
  3. ステップ 2 — スライスする
  4. ステップ 3 — 変換をスキルとして書く
  5. ステップ 4 — 並列セッションを回す
  6. ステップ 5 — 進捗バーではなくエラー率を見る
  7. 検証チェックリスト
  8. 落とし穴
  9. 理解度チェック
  10. 実録 —— 移行ループを逐次実行、Devin CLI v3000.14(swe-2-flash-medium)
  11. 出典

ガイド 11 — スケールする移行

目標: 大規模移行(言語、フレームワーク、データベース、依存関係、アーキテクチャ)を 1 回の英雄的リライトではなく、数百の小さな検証済み PR として実行する。 レベル: 中級 → 上級 出典: ベストプラクティス · 移行とモダナイゼーション · 移行例:Java アップグレード、COBOL、SAS→PySpark、JS→TS、NoSQL→SQL · Nubank ケーススタディ

公式プレイブック

Devin 自身のドキュメントはスケールするものを率直に述べている:広く浅くが高く深くに勝る。移行は典型的な広く浅い仕事——同じ小さな変換を数百の独立単位に適用する。

移行 ──► 孤立した単位にスライス(各 90 分以内)
                 │
        ┌────────┴────────┐
        ▼                 ▼
   変換のスキル      並列セッション、
                    各 1 スライス
        │                 │
        └────► スライスごとに検証(テスト/ビルド/CI)
                        │
              人間レビュー → マージ → 繰り返し

ステップ 1 — 移行が適格か確認する

公式基準から——ほとんどが成立すべき:

不適格:すべてが一度に着地しなければならない全リポジトリのリライト。

ステップ 2 — スライスする

スライスは最小の原子単位——ファイル、ノートブック、モジュール:

ルール 理由
スライスあたり手作業 90 分未満 Devin の信頼性はスライス単位
独立 + 後方互換 スライスは並列で走り任意の順でマージできる
各スライスが自身の検証を持つ 検証なし、自動化なし——これが失敗ゲート

公式の例:50 ファイルの REST→GraphQL 移行 → スコープを定め、競合しない作業パッケージに分割し、並列で実行。

ステップ 3 — 変換をスキルとして書く

1 スキル = 全セッションが実行する再現可能なレシピ。公式例(Java 7→8、抜粋):

## Procedure
1. Verify the project is on Java 7
2. Install the Java 8 JDK
3. Update build configuration
4. Identify and replace deprecated Java 7 APIs
5. Analyze for Java 8 enhancement opportunities
6. Update unit tests
7. Test thoroughly
8. Update documentation
9. Build and verify

あなた版に含めるもの:明示的な手順、エンドツーエンドの参照(ガイドまたは動画)、複数の前後コード例——入出力ペアは与えられる最高品質のシグナル。

ステップ 4 — 並列セッションを回す

スキルが固まったら、スライスをセッション群に展開——API または Bot の子セッション(ガイド 4)。スライスごとに → 1 セッション → 1 PR。main へのマージは人間レビューがゲート。

スケールでは数値が複利になる:Nubank の数百万行 ETL 移行はこのループで効率 8–12 倍——ファインチューンされた Devin がタスクあたり時間を約40分→約10分に削った。

ステップ 5 — 進捗バーではなくエラー率を見る

小さなエラー率は数千スライスで複利になる。雰囲気ではなくダッシュボードで運用する:

検証チェックリスト

落とし穴

理解度チェック

  1. なぜ「深く完全な」スライスでなく「広く浅い」スライスか?(各スライスがグリーンで着地しなければならない——90 分の検証済み PR は複利になる;3 日のメガブランチは main に対して腐る)
  2. なぜすべてのスライスが独自の検証を要るのか?(スライスごとの証明がなければ、500 PR の移行は 500 の未検証 diff——失敗面は分割されるのでなく増殖する)
  3. Nubank が 8–12 倍の効率を報告——それをマーケティングでなく信頼できる数値にしたものは?(公開された方法論:実際の ETL パイプラインで前後の段階時間を計測、予測ではなく)

実録 —— 移行ループを逐次実行、Devin CLI v3000.14(swe-2-flash-medium)

数百の並列セッションはクラウドのクォータが必要——だがループ自体には不要。無料枠で逐次実行した。migrate-demo:optparse CLI 4 本(greeter/calc/backup/report)、ツールごとに振る舞いテスト、変換レシピは .devin/skills/optparse-to-argparse/SKILL.md。プロンプト:「独立したスライスとして移行……各ツールを移行したらテストを実行し、緑になってから次へ。」

動画(41 秒・無音): ベースライン → skill 呼び出し → 4 スライスそれぞれで緑 → optparse 残存ゼロ。

スライスループ全体——各ツール移行後にテスト緑、レシピどおりのまとめ

1. ベースライン——optparse ツール 4 本、振る舞いテスト 7 件全緑 1. ベースライン:OptionParser 4 本・テスト 7 件・skill レシピをコミット済み

2. .devin/skills から skill が自動呼び出し——まず全ツールとテストを読む 2. Invoked skill optparse-to-argparse——レシピが実行を駆動

3. スライスループ——「Green. Now calc.py——rest で位置引数を読むので parse_known_args で形を保つ」 3. スライスごとに検証。calc.py に parse_known_args が必要な点も自力で検出

4. /exit 後に検証——4 ファイル移行、+18/−18、optparse 参照ゼロ、コミットなし 4. 検証済みの小さな diff ×4——スライス規律そのもの(並列フリートは除く)

出典