用途：agents-sync 用于生成并同步各类 AI 编码工具的上下文文件，让不同工具共享同一份项目上下文。它通过 MCP 服务器接入 Claude Code，以斜杠命令方式调用。
主要能力：init 首次扫描代码库（清单、结构、源码样本、文档、TODO/FIXME 注释），经 Claude API 提取项目元数据，生成规范 AGENTS.md，并派生出 CLAUDE.md、.cursorrules、.github/copilot-instructions.md、GEMINI.md、.windsurfrules、.clinerules、.roomodes、CONVENTIONS.md、.kiro/steering/agents-sync.md、.trae/rules/agents-sync.md，同时保存快照用于漂移检测。sync 在代码变更后重新同步并保留手动定制，支持 --fast 与 --dry-run。derive 从当前 AGENTS.md 重新派生所有工具文件。drift 只读检查代码库变化。export [tool] 重新派生单个工具文件，支持 claude、cursor、copilot、gemini、windsurf、cline、roo、aider、kiro、trae。validate 检查文件是否与 AGENTS.md 同步，支持 --strict/--ci。lint 校验代码库是否符合 AGENTS.md 中可机械检查的 Never 规则。status 显示同步状态、受管文件与漂移分数。scan 显示扫描到的语言、框架、依赖、MCP 服务器，无需 API key。install-hook 安装 pre-commit 钩子（阻止上下文文件漂移的提交）与 Claude Code SessionStart 钩子，可用 --no-session-hook 仅装前者。
使用方式：在 Claude Code 的 MCP 配置（.claude/settings.json 或 ~/.claude/claude_desktop_config.json）中加入 mcpServers 配置，command 为 npx，args 为 ["@googlarz/agents-sync"]，env 中设置 ANTHROPIC_API_KEY，然后重启 Claude Code。之后输入 /agents-sync <command> 调用对应 MCP 工具，projectPath 默认取当前工作目录。init 后需将 AGENTS.md 加入 git，并将 .agents-sync/ 加入 .gitignore。
自定义：可在任意受管文件中用 <!-- AGENTS-SYNC:CUSTOM:START --> 与 <!-- AGENTS-SYNC:CUSTOM:END --> 包裹永久定制内容，重新同步时会保留。
限制：需要 ANTHROPIC_API_KEY（scan 除外）；依赖 Claude Code 与 MCP 连接；具体收费、价格、平台支持与效果资料暂未提供。