Ruler — One Source of Truth for Agent Rules

简介

适合谁：同时使用多种 coding agent 的团队，希望让指令与 MCP 配置跨工具保持一致

适用环境：Node.js + npm/npx、包含 CLAUDE.md/AGENTS.md/.cursor 等配置的仓库、可选的多层项目结构

安装耗时：10 分钟

量化信息

• 支持 Claude Code/Cursor/Codex/Copilot 等（仓库）
• 装机约 10 分钟

用好它的方式

先写一个短的 .ruler/AGENTS.md 把真实流程（测试/风格/安全）固化下来；只有当不同子组件确实不同，才开启 nested 模式。

推广清单

• 先选一个真实任务，小范围试跑
• 记录基线：首次成功耗时与输出质量
• 配置/技能要版本化，避免团队漂移

风险与护栏

生成文件就保持生成：不要在下游手改；把 .ruler/ 当成唯一可编辑入口。

FAQ

Q: 能直接全员推广吗？ A: README 标注为 beta/research preview；建议先在一个仓库试点，并把回滚路径写清楚。

Q: 怎么避免配置漂移？ A: 规则集中存放在 .ruler/，再由 Ruler 生成下游配置文件，维护点只有一个。

Q: monorepo 好用吗？ A: 可以。仓库说明了 nested 规则加载：多个 .ruler/ 目录可按范围输出到不同配置。