用途：Plugin Replicator 是面向开发者本机的工具，用于在多个本地项目之间保持插件源码同步，避免手动复制。它是双向的，源和目标都只是路径，因此既可推送（向外分发更新），也可拉取（把最新版本拉到消费方项目）。
主要能力与模式：默认 Additive（只复制新增/更新文件，不删除目标文件）；--clean（复制新增/更新，并删除源中已不存在的目标文件）；--link（创建实时符号链接，始终反映源，适合开发）；--dry-run（只打印将要执行的操作，不做改动）。
使用方式：交互式执行协议要求先引导发现（插件范围、目标项目 plugins/ 的绝对路径、模式、是否先预览），再复述任务并确认，最后生成命令。拉取模式在消费方项目中运行，例如 python3 plugins/plugin-manager/scripts/plugin_replicator.py --source /Users/richardfremmerlid/Projects/agent-plugins-skills/plugins/<plugin-name> --dest plugins/<plugin-name> --clean。推送模式在本仓库运行，将 --source 设为 plugins/<plugin-name>，--dest 设为其他项目的对应路径。批量推送使用 bulk_replicator.py：--source plugins/ --dest /path/to/other-project/plugins/；可加 --filter "obsidian-*" --clean 过滤。
适用场景：新项目初始化时批量复制全部插件；推送插件更新；传播删除（配合 --clean）；活跃开发时用 --link 从源工作并在目标即时测试。
限制与后续：复制完成后，需在目标项目运行 plugin-maintenance Sync，以在 .agent/、.claude/、.gemini/ 等目录中激活插件。其余平台支持、依赖或安装要求暂未提供。