用途：将 manifest-dev 插件的 agents、hooks、skills 同步到仓库的 .claude/ 目录，只管理自己写入的文件，保留项目本地内容与其他插件。
主要能力：支持无参数同步当前仓库、--all 批量同步多个仓库（每个仓库一个 PR）、--check 只报告变更不写入。同步范围含两个插件的 agents/、hooks/、skills/，同名冲突时 manifest-dev-tools 优先，排除 .claude-plugin/ 与 README.md。用 .claude/.manifest-dev-sync.json 记录已同步项，只有 tracked 中的条目才可删除。
使用方式：先克隆并暂存源： git clone --depth 1 https://github.com/doodledood/manifest-dev /workspace/manifest-dev bash .claude/skills/sync-manifest-dev/stage-source.sh 再运行： python3 .claude/skills/sync-manifest-dev/sync.py <repo-root> /tmp/manifest-dev/claude-plugins <source-commit> [--check] 脚本会校验同步内容，不一致时非零退出；报告写入 /tmp/manifest-dev-sync-report-<repo>.json。
适用场景：维护多个仓库中 manifest-dev 插件副本的一致性，处理普通布局与 .agents/ 镜像、反转布局、符号链接分类（direct、mirror、adopt、foreign）。
限制：不要手工重推算法；不得写入、删除或进入 foreign 符号链接；不得把跳过项记入 tracked；不得替换 .agents/skills/<name> 的非符号链接；不得创建 .agents/ 本身；不得删除 tracked 之外的内容；不得删除 sync-manifest-dev 技能；不得复制插件元数据或修改源仓库。上游当前没有 agents/ 或 hooks/ 目录属正常。