rulesync：让 AI Coding Agent 遵守项目规范

Coding Agent 每次新建文件都靠 Prompt 约束代码风格，项目规范形同虚设。rulesync 是一个专门给 AI Coding Agent 用的规范同步 CLI，让 Claude Code、Codex 等 Agent 始终知道你的团队规范是什么。

rulesync（dyoshikawa/rulesync，⭐ 1,345，MIT，TypeScript）是一个 Utility CLI，核心功能是把项目代码规范（ESLint 规则、Prettier 配置、TypeScript 设置、提交规范等）转换成 AI Agent 能够理解的上下文，让 Agent 在每次操作时都能感知并遵守规范。

核心数据

它解决什么问题

用 Claude Code 等 Agent 写代码时，每次都要靠 Prompt 提醒它”用 Prettier 格式化”、”遵循项目 import 顺序”、”commit message 要符合规范”——这些信息散落在 .eslintrc、prettierrc、.commitlintrc 等配置文件里，Agent 并不能自动读取并遵守。

rulesync 的思路是把这些配置文件翻译成 AI 可读的规范文档，并在 Agent 每次运行时自动注入：

项目配置 → rulesync 解析 → AI 可理解的规范 → 注入 Agent 上下文

技术亮点

1. 多规范格式支持

ESLint       ✅  |  Prettier    ✅  |  TypeScript ✅
CommitLint   ✅  |  EditorConfig ✅  |  .gitattributes ✅

2. AI 友好的规范输出

# 生成 AI 可读规范文档
rulesync generate > .ai/rules.md

# 在 Claude Code 中引用
# .claude/settings.json 中配置 rulesync 自动注入

生成的规范文档是 Markdown 格式，Claude Code 等 Agent 可以直接读取并遵守。

3. 与 Agent 无缝集成

// .claude/settings.json
{
  "rules": "$(rulesync generate)"
}

Claude Code 启动时自动加载规范，不需要每次手动提示。

4. 零依赖，仅 CLI

npm install -g rulesync
rulesync generate

TypeScript 编写，Node.js 即可运行，不引入额外运行时依赖。

快速使用

npm install -g rulesync

# 在项目目录运行
rulesync generate

# 输出 AI 可读规范到 stdout
# 或直接注入 Claude Code 配置

和普通 Lint 配置的区别

普通 Lint：只在人工提交时触发，AI 写代码时感知不到。
rulesync：把规范转成 AI 上下文，让 Agent 在写代码时就遵守，而不是事后审查才发现问题。

项目地址：github.com/dyoshikawa/rulesync