用途:该技能是 SDD Devkit 插件中迁移逻辑的唯一归属,负责把先前版本插件遗留在项目中的内容(文件夹结构、模板格式、跨版本变化的约定)规范化为当前有效结构。其余技能只基于当前结构工作,遇到旧结构内容时会停下并交给它。
主要能力:按 references/migrations.md 中的迁移目录逐族检测并规范化;检测是结构性的(与现行 layout 和模板比对,不依赖版本标记);支持完整扫描(用户直接调用)与限定范围扫描(其他技能派生调用)两种模式;迁移后重建内部路径引用,并输出旧路径到新路径的映射。
使用方式:执行前必须阅读 ${PLUGIN_ROOT}/references/language.md 与 ${PLUGIN_ROOT}/references/linking.md;先完整阅读 references/migrations.md 再扫描。共享引用写作 ${PLUGIN_ROOT}/references/<文件>.md,其中 ${PLUGIN_ROOT} 为插件安装根目录(含 skills/、agents/、references/ 的文件夹),可由调用时给出的技能基目录上溯两级得到,或通过查找插件清单定位:PLUGIN_ROOT="$(dirname "$(grep -rl '"name": *"sdd-devkit"' "$HOME/.claude/plugins" --include=plugin.json 2>/dev/null | head -1)")",使用前需确认 $PLUGIN_ROOT/references/language.md 存在。流程为:扫描、用结构化提问一次性提出计划、按批准逐族应用并展示 diff、更新内部引用、收尾并做幂等性验证。
限制:只迁移结构不迁移内容,不重写、摘要或翻译用户措辞;保留既有标识符编号与格式;模板要求而原文缺失的段落留模板占位,由拥有该内容的技能填写;不得未确认即写入;git 仓库中用 git mv 移动但不提交;无法自动重写的引用(仓库外消费者、外部追踪器)列入报告。
适用场景:直接调用(如“迁移项目”“把内容规范化为插件新格式”)或由其他技能在发现旧版结构后派生调用。
其余细节(如具体迁移族清单、模板细节)暂未在提供资料中给出,请以 references/migrations.md 为准。