feat(migration): 建立 Skill 迁移工作流与追踪工具

migration/README.md

@@ -2,6 +2,16 @@
 
 本目录只记录来源指纹、迁移状态和人工复核结果，不存放或打包公司插件内容。
 
+- [迁移计划](MIGRATION_PLAN.md)：批次顺序、依赖、合并策略与验收门禁。
+- `source-lock.json`：可提交的来源指纹和迁移状态。
+- `local-sources.json`：本地来源路径，不提交；结构参考 `local-sources.example.json`。
+- `scripts/scan_sources.py`：只读生成来源 Skill 指纹清单。
+- `scripts/check_skill.py`：检查迁移后 Skill 的结构、引用和敏感内容。
+- `scripts/update_lock.py`：根据扫描报告预览或更新迁移台账。
+- `tests/`：迁移脚本的隔离行为测试。
+
+扫描报告可能包含来源 Skill 名称和相对路径，应写入本地临时目录或忽略文件，不进入插件发布内容。
+
 同步流程：
 
 1. 读取来源仓库当前提交与 Skill 文件哈希。
@@ -10,4 +20,4 @@
 4. 在 CraftKit 中独立重写并完成验证。
 5. 更新来源指纹、目标路径、状态和复核日期。
 
-允许的状态：`pending`、`rewriting`、`migrated`、`excluded`、`review`。
+允许的状态：`pending`、`specified`、`rewriting`、`review`、`migrated`、`excluded`、`superseded`。