ai-rules-sync
AI编码规则文件同步与转换工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ai-rules-sync。 它的用途是：AI编码规则文件同步与转换工具 完整的 Skill 内容见：https://321skill.com/skills/ai-rules-sync/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用agentsync将项目中的.cursorrules转换为CLAUDE.md，并同步到其他规则文件。' AI会执行agentsync convert .cursorrules --to claude -o CLAUDE.md，然后运行agentsync sync确保所有文件一致，同时检查lint规则。
介绍
这个Skill解决了多个AI编码代理规则文件分散、难以同步的问题。在实际开发中，开发者可能同时使用Claude Code（CLAUDE.md）、Cursor（.cursorrules）、GitHub Copilot（.github/copilot-instructions.md）以及Codex（AGENTS.md），手动维护这些文件内容一致非常繁琐且容易出错。agentsync提供了一个统一的命令行工具，能够自动转换和同步所有主流规则格式。
使用方式非常简单，你只需要安装npm包后运行agentsync setup即可一键初始化项目。它会自动扫描项目生成AGENTS.md作为单一事实源，并创建agentsync.json配置文件。之后通过agentsync sync命令即可将AGENTS.md的内容同步到其他规则文件，并支持git pre-commit钩子自动同步。此外，还提供了agentsync convert、agentsync generate、agentsync lint等子命令，以及浏览器在线playground，方便快速测试和调试。
它非常适合需要同时使用多个AI编码代理的团队或个人。尤其是那些已经在Claude Code、Cursor、Copilot等工具之间切换，希望保持规则一致的开发者。对于需要统一团队编码规范、减少重复配置的团队来说，agentsync能显著提升效率，避免因规则不同步导致的AI行为不一致。
建议在项目初始化时就使用agentsync setup建立同步机制，将AGENTS.md作为唯一编辑源，其他文件自动生成。需要注意的是，它依赖Node.js 18+环境，但零外部依赖，安装后即可使用。它主要支持主流规则格式，对于自定义文件名需要手动配置targets数组。
常见问题
如何安装agentsync？
全局安装：npm install -g @panishandsome/agentsync，或使用npx直接运行：npx @panishandsome/agentsync --help。
如何将现有规则文件转换为AGENTS.md？
运行 agentsync convert .cursorrules --to agents -o AGENTS.md，即可将.cursorrules转换为AGENTS.md格式。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ai-rules-sync/raw/index.md 读取 ai-rules-sync 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ai-rules-sync/raw/index.md（查看排版版本）