megatron-migration-generator

Megatron 移行ジェネレーター

上流の変更分析と影響範囲のマッピングによって、信頼度の高い項目に作業対象を絞り込んだ後に限り、MindSpeed 向けの実装指向の移行成果物を生成します。目的は、小さなパッチのヒントを出力することではなく、上流コミットを主要な参照元として、上流の機能を MindSpeed に移植することです。

デフォルトの出力モード

デフォルトでは report + patch を使用し、ユーザーが別のロケールを明示的に指定しない限り、最終的な Markdown 成果物は中国語で生成します。

コードを直接編集したり、自動でコミットしたりすることをデフォルトにしないでください。 最小限のパッチ案ではなく、実装を優先したパッケージをデフォルトにしてください。

サポートされるモード

1. report 移行レポートのみを生成します。
2. patch 移行レポートと、完全な実装リファレンスパッケージを生成します。デフォルトでは、機能ごとのフォルダーに full.patch、分割された patches/、上流の参照メタデータ、実装チェックリスト、明示的な未対応範囲を含めます。
3. apply コミットを作成せずに、ローカルのワークスペースを編集します。アラインメントと影響範囲の信頼度が高い場合に限り使用します。
4. commit パッチのレビュー後に、ユーザーから明示的な依頼があった場合に限り使用します。最初の段階でのデフォルトとして使用しないでください。

開始条件

以下のすべてを満たす場合にのみ進めてください。

• MindSpeed のブランチが判明している。
• Megatron のベースブランチが判明している。
• Megatron のターゲットブランチまたは変更セットが判明している。
• 関連する影響範囲の項目がすでに存在する。
• 移行対象となる各項目に、上流コミットへの参照と、設定、ランタイム、ラッパー、テストの作業を区別できるだけの実装範囲が含まれている。

不足しているものがあれば、推測せずに停止し、不足している前提条件をユーザーに確認するか、導き出してください。

ワークフロー

1. 影響範囲レポートを読みます。
2. 信頼度の高い項目と、推測に基づく項目を分けます。
3. 信頼度の高い項目ごとに、以下を記述します。 上流での変更内容、 上流コミットと変更されたファイル、 上流の実装単位、 ローカルでの適応先、 想定されるコード変更、 不確実性。
4. 以下を生成します。 統合された migration_report.md を1つ 引き継ぎに必要な場合は impact_report.json 簡潔なサマリーインデックスとして candidate_patch.md 移行項目ごとにサブフォルダーを1つ含む features/ ディレクトリ。各サブフォルダーには以下を含めます。 完全なローカル実装ドラフトを記載した full.patch 実装単位ごとに整理した分割パッチシリーズを含む patches/ 互換性エントリーパッチとしての candidate.patch README.md、checklist.md、package_manifest.json、upstream_reference.json
5. apply モードの場合、承認されたファイルのみを編集し、変更内容を明確に説明してください。

安全ルール

• 影響範囲レポートなしに、生のコミット履歴から移行コードを直接生成しないでください。
• 調査モードでの直接編集は避けてください。
• ターゲットが megatron main の場合、コード出力は互換性が保証された移行ではなく、適応候補のドラフトとして扱ってください。
• ブランチの整合性が変化している場合、レビューしやすく安全性も高いため、コミットよりパッチ成果物を優先してください。
• 上流コミットが設定、ランタイムロジック、ラッパー、テストにまたがる場合、ローカルファイル1つの編集を完全な機能移行として扱わないでください。
• 利用可能な入力だけでは完全な移行パッケージを作成できない場合、機能が完成したかのように装わず、未対応の実装単位、省略した範囲、手動でのフォローアップを明示的に記録してください。

静的検証

検証は軽量なローカル確認にとどめてください。

• パッチが問題なく適用できる
• パスが存在する
• 名前と引数がローカルのコード構造と一致する
• 利用可能な場合は、基本的な構文チェックまたは lint レベルのチェックを行う
• 上流の実装単位のうち、移植済みのものと、まだ移植が必要なものをパッケージ内で説明する

学習の正確性、性能、数値精度が検証済みであるかのように示さないでください。

参考資料

• 出力形式を選択する前に、migration-modes.md をお読みください。
• 機能の実装を表すと明記した移行パッケージを生成する前に、implementation-first-package.md をお読みください。
• 想定される統合済み Markdown 成果物の構成については、report-template.md をお読みください。レポートの言語は、特に指定がなければ中国語です。
• 既知の機能コミットを単一ファイルのプレースホルダーのままにせず、より完全な複数ファイルのパッチシリーズに展開したい場合は、影響範囲のマッピング後に synthesize_full_patch_series.py を実行してください。
• 手動で調整する前に、impact_report.json をレビュー可能なレポートとパッチ計画の成果物に変換するには、render_migration_artifacts.py を実行してください。