intellectronica/ruler

解决的问题

管理多个 AI 编码助手（如 GitHub Copilot、Cursor 和 Claude）的指令时，常常会导致指导不一致、多个配置文件间的重复工作以及上下文漂移。Ruler 提供这些指令的单一真实来源，确保项目中的所有 AI 代理无论使用何种工具，都遵循相同的规则。

工作原理

Ruler 使用 Markdown 文件将 AI 指令集中存储在 .ruler/ 目录中。当运行 apply 命令时，它会将这些规则合并，并自动分发到各种受支持的 AI 代理所需的特定配置文件中。它支持嵌套规则加载，允许开发者在子目录中放置 .ruler/ 目录，为项目不同组件（例如前端和后端）提供上下文相关的指令。

适用人群

使用多种 AI 编码工具的开发者和团队，希望在整个代码库中保持一致的 AI 行为和项目特定的指导方针。

主要亮点

• 集中管理：使用 Markdown 将所有指令存储在一处。
• 广泛代理支持：兼容大量工具，包括 GitHub Copilot、Claude Code、Cursor、Windsurf、Aider 等。
• 嵌套规则加载：通过递归发现 .ruler/ 目录，支持复杂项目结构和 monorepos。
• MCP 服务器传播：管理并分发 Model Context Protocol (MCP) 服务器设置到各个代理。
• 自动化：自动更新 .gitignore，将生成的代理配置文件排除在版本控制之外。