Rulesync：AI 编码工具配置统一管理 CLI

项目简介

Rulesync 是一个 Node.js 命令行工具，用于从统一的 AI 规则文件自动生成各类 AI 开发工具的配置文件。适合同时使用 Claude Code、Cursor、GitHub Copilot、Codex CLI 等多种 AI 编码工具，希望只维护一份规则配置的开发者。它提供按目标选择性生成、导入导出，以及规则、命令、MCP、ignore 文件、subagents、skills 等内容的同步能力。

主要功能

• 统一配置源：在 .rulesync/ 中维护规则，再生成到不同 AI 工具。
• 多工具目标：通过 --targets 指定要生成配置的工具。
• 选择性生成：通过 --features 选择需要生成的功能类型。
• 支持范围包括 rules、ignore、mcp、commands、subagents、skills、hooks、permissions、checks，不同工具的支持情况不同。
• 导入现有配置：可从 CLAUDE.md、.cursorrules、.github/copilot-instructions.md 等文件导入。
• 直接转换：可在不写入 .rulesync/ 的情况下，把一个工具的配置转换成另一个工具的配置。
• 可获取官方 skills：rulesync fetch dyoshikawa/rulesync。

安装与使用

使用 npm 全局安装：

npm install -g rulesync

macOS 和 Linux 也可以通过 Homebrew 安装：

brew tap dyoshikawa/rulesync https://github.com/dyoshikawa/rulesync
brew install rulesync

初始化项目并生成配置：

rulesync init
rulesync fetch dyoshikawa/rulesync
rulesync generate --targets "*" --features "*"

导入已有配置：

rulesync import --targets claudecode
rulesync import --targets cursor
rulesync import --targets copilot

直接转换配置：

rulesync convert --from cursor --to copilot,claudecode

更多安装方式与平台说明见安装文档，快速上手见快速开始。

注意事项

• 使用 Homebrew 时必须采用两参数形式 brew tap <name> <url>；未先 tap 就执行 brew install dyoshikawa/rulesync/rulesync 不可用。
• 各 AI 工具对 rules、ignore、mcp、commands、subagents、skills、hooks、permissions、checks 的支持并不一致，具体以支持工具参考为准。
• 表中标注 ⚠️ 的工具已弃用，但仍受支持。
• Rulesync 负责生成和转换配置，不替代各 AI 编码工具本身。

本作品整理自 GitHub 开源项目 dyoshikawa/rulesync，原作者 @dyoshikawa，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。