CraftKit/migration/README.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 文件哈希。
2. 与 source-lock.json 比较，生成新增、修改、删除清单。
3. 人工判断变化是否属于可公开迁移的通用能力。
4. 在 CraftKit 中独立重写并完成验证。
5. 更新来源指纹、目标路径、状态和复核日期。

允许的状态：pending、specified、rewriting、review、migrated、excluded、superseded。