mindspeed-fsdp2-model-migration

Migrates models to MindSpeed-MM FSDP2 preserving source semantics via @model_register and signature checks.

31|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Ascend/agent-skills --skill mindspeed-fsdp2-model-migration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mindspeed-fsdp2-model-migration
Source: https://github.com/Ascend/agent-skills/tree/main/skills/mindspeed-mm-fsdp2-migration/mindspeed-fsdp2-model-migration
Command: npx skills add https://github.com/Ascend/agent-skills --skill mindspeed-fsdp2-model-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

在模型迁移到 MindSpeed-MM FSDP2 时,提供统一的注册与加载契约框架,确保在插件化、签名兼容、token/embedding 更新及前向兼容方面保持源模型语义的一致性。

Core Features & Use Cases

  • 模型插件注册与加载契约:在 MindSpeed-MM 框架下创建和注册模型插件,确保模型能够正确加载与执行。
  • 签名兼容与迁移检查:对 from_pretrained、_from_config 路径进行兼容性校验,输出必要的合规性报告。
  • Token/Embedding 适配:在需要时进行 token 与 embedding 的位移、重设或初始化,保障推理一致性。
  • Use Case:将现有模型迁移至 MindSpeed-MM FSDP2 并在 ModelHub/加载链路中保持行为一致。

Quick Start

Create a MindSpeed-MM FSDP2-compatible model plugin and verify loading signatures for the target model.

Frequently Asked Questions about mindspeed-fsdp2-model-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a model to MindSpeed-MM FSDP2 while preserving source semantics?▼

To migrate a model to MindSpeed-MM FSDP2 while preserving source semantics, you create a model plugin under mindspeed_mm/fsdp/models, register it via @model_register, and validate loading signatures to ensure forward compatibility.

What is the purpose of model_contract_checklist and signature_compat_report in FSDP2 migration?▼

The model_contract_checklist and signature_compat_report are optional validation checks that verify from_pretrained and _from_config path compatibility, outputting compliance reports to ensure consistent model loading behavior during FSDP2 migration.

How to handle token and embedding updates when migrating to MindSpeed-MM FSDP2?▼

To handle token and embedding updates during MindSpeed-MM FSDP2 migration, you perform token displacement, resetting, or initialization as needed to adapt embeddings, ensuring inference consistency and forward compatibility within the model plugin.

Does MindSpeed-MM FSDP2 migration require specific loading paths for pretrained models?▼

Yes, MindSpeed-MM FSDP2 migration requires compatible from_pretrained and _from_config loading paths to be established within the model plugin, ensuring the registered model executes correctly and maintains behavioral consistency across the loading chain.

Why does my migrated model lose behavior consistency in the ModelHub loading chain?▼

Behavior consistency is lost when model plugins lack proper registration contracts or compatible loading signatures, which this FSDP2 migration framework resolves by enforcing @model_register contracts and validating from_pretrained paths.

Can I use this approach to create model plugins for any architecture under MindSpeed-MM?▼

Yes, you can create FSDP2-compatible model plugins for target architectures under mindspeed_mm/fsdp/models, provided you satisfy the registration contracts, loading signatures, and embedding/token updates required for forward compatibility.