用途:同步项目中 Agents.md、claude.md 和 gemini.md 三个 AI Agent 配置文档,保持内容一致,避免手动维护多份相同文档。
主要能力:递归扫描当前目录下所有文件夹,自动发现这三个文件;将同一文件夹下的文件归为一组同步;若某组只有一个文件,复制其内容创建其余两个;若有多个文件,以最新修改的作为源同步到其他文件;watch 模式持续监听文件变化并触发同步;支持手动单次执行。默认跳过 node_modules、.git、.next、dist 等目录。
使用方式:先进入工具目录执行 pnpm install 安装依赖。手动同步可在项目根目录执行 node .../doc-sync-tool/sync.js,或使用 pnpm run sync;自动监听执行 node .../doc-sync-tool/watch.js,或使用 pnpm run watch;后台运行可用 pm2 start .../watch.js --name doc-sync,并用 pm2 status 查看、pm2 stop doc-sync 停止。配置可在 sync.js 中修改 targetFiles、scanPath、excludeDirs。
适用场景:在多个 AI Agent 之间共享相同的项目配置,自动保持不同 AI 的工作指令一致。建议在 Git 仓库中使用以便追踪变化。
限制与说明:需 Node.js 14+;依赖安装失败可删除 node_modules 和 package-lock.json 后重新 pnpm install;权限问题可执行 chmod +x sync.js watch.js;监听模式持续运行,建议用 PM2 管理。同步保留文件原始格式和内容。其他收费、价格与平台等信息暂未提供。