Everything Claude Code Rules 体系为 Claude Code、Codex、Cursor 等 AI 编程助手提供了通用与语言专属的行为规范持久化配置。通过 common/ 通用规则与 TypeScript、Python、Golang、Web、Swift、PHP 等 12 种语言/领域规则集的分层设计，结合按需安装策略，Rules 能将“应该怎么做”的标准注入到所有 Agent/Skill 的自动化流程中，显著提升多 AI 协作下的开发一致性、安全性与效率。

Everything Claude Code Rules 体系详解：12 种语言规则集的设计思路与按需安装指南

在 AI 辅助编程进入生产级阶段后，如何让 Claude Code、Codex、Cursor 等助手真正“懂你的团队规范”，并且在每一次自动化协作、代码生成、审查和 Hook 触发时都能遵循统一的标准？Everything Claude Code Rules 体系正是为此而生。本文将详解其分层结构、安装策略、与 Skills/Agents/Hooks 的关系，以及如何通过 rules-distill Skill 自动提炼跨项目原则，帮助你系统性提升 AI 编程效率。

1. Rules 体系是什么？解决什么问题？

Rules 是 Everything Claude Code 的“行为规范持久化配置”，不同于每次对话都要重复输入的提示词（prompt），它将团队的开发标准、代码风格、安全要求、测试覆盖率等，以结构化文档的形式注入到 AI 助手的上下文中，实现一次配置，持续生效。这让所有 Agent、Skill、Command 和自动化 Hook 都能在执行时自动遵循你的团队规范，极大提升了协作一致性和安全性。

Rules 体系采用分层设计，分为：

common/：通用规则，适用于所有项目和语言（如代码风格、Git 工作流、安全基线等）。
语言专属目录（如 typescript/、python/、golang/、web/、swift/、php/ 等）：在 common 基础上，叠加各语言/领域的最佳实践、工具链、代码示例和特有约束。

这种分层不仅保证了“通用标准不丢失”，还能让每种技术栈的 Agent/Skill 自动获得最优的本地化行为规范。

2. Rules 的结构与设计思路

Rules 目录结构如下：

rules/
├── common/          # 通用原则（必须安装）
│   ├── coding-style.md
│   ├── git-workflow.md
│   ├── testing.md
│   ├── performance.md
│   ├── patterns.md
│   ├── hooks.md
│   ├── agents.md
│   └── security.md
├── typescript/      # TypeScript/JavaScript 专属
├── python/          # Python 专属
├── golang/          # Go 专属
├── web/             # Web/前端专属
├── swift/           # Swift 专属
└── php/             # PHP 专属

common/ 目录下的规则文件不包含任何语言特定内容，适用于所有项目，是基础层。
语言专属目录中的每个文件都以“本文件扩展了 common/xxx.md”开头，明确说明与通用规则的关系，并在必要时覆盖或补充 common 的内容。
例如，golang/coding-style.md 会覆盖 common 层的“推荐不可变数据结构”原则，说明 Go 领域的惯用做法（如指针 receiver 结构体可变性）。

优先级原则：当语言专属规则与 common 规则冲突时，以专属规则为准，遵循“具体优先于通用”的 layered 配置模式（类似 CSS specificity 或 .gitignore 覆盖逻辑）。

3. Rules 的安装与按需激活

推荐方式：一键安装脚本

你可以通过官方脚本按需安装 common 及所需语言规则集，极大减少上下文 token 占用：

bash

# 安装 common + 某一语言规则
./install.sh typescript
./install.sh python
./install.sh golang

# 支持多语言一次安装
./install.sh typescript python

手动安装（进阶自定义）

注意：必须复制整个目录，不能用 /* 扁平化！
否则会导致同名文件被覆盖，破坏语言专属规则对 common 的引用关系。

bash

# 安装通用规则
cp -r rules/common ~/.claude/rules/common

# 按需安装语言专属规则
cp -r rules/typescript ~/.claude/rules/typescript
cp -r rules/python ~/.claude/rules/python
cp -r rules/golang ~/.claude/rules/golang
# ...按需添加

安装建议：只安装你实际用到的语言规则，避免不必要的上下文占用，提升响应速度和准确率。

详细的安装与多平台部署方法，可参考 Everything Claude Code 安装配置指南：Selective Install、多平台部署与 configure-ecc 向导。

4. Rules 与 Skills/Agents/Hooks 的关系

Rules 负责定义“应该怎么做”（如 80% 覆盖率、禁止硬编码密钥、PR 流程等），是行为标准和检查清单。
Skills（skills/ 目录）则提供“怎么做”的详细操作、代码示例和最佳实践（如 python-patterns、golang-testing 等）。
语言专属规则文件会在适当位置引用相关 Skills，形成“原则-方法”联动。例如，python/coding-style.md 会提示“详见 skill: python-patterns”。

Rules 与 CLAUDE.md 的区别：Rules 是团队级、跨项目的持续行为规范，CLAUDE.md 则是每个项目的上手说明、架构地图和定制提示，两者互补。你可以参考 Everything Claude Code 完全指南：38 Agent + 156 Skill 的生产级 AI 编程插件了解两者在整体生态中的定位。

Hooks（自动化钩子）体系会根据 rules 配置自动触发格式化、类型检查、安全扫描等操作。例如，TypeScript 规则集自动集成 Prettier、tsc、console.log 检查等 PostToolUse/Stop 事件，详见 Everything Claude Code Hooks 实战：PreToolUse / PostToolUse / Stop 事件驱动自动化完全配置。

5. 如何为新语言/领域扩展 Rules？

只需 4 步：

新建 rules/xxx/ 目录（如 rust/、dart/、database/ 等）。
按 common 层结构添加规则文件（如 coding-style.md、testing.md、patterns.md、hooks.md、security.md）。
每个文件开头注明“本文件扩展了 common/xxx.md”，并补充/覆盖与该语言相关的规范、工具和示例。
如有需要，引用或新建对应的 Skill（如 rust-patterns、dart-testing 等）。

对于像 web/ 这样的领域规则，也可采用同样的 layered 结构，只要有足够的复用价值。

6. 自动提炼跨项目原则：rules-distill Skill

随着 Skill 库和项目经验的积累，团队往往会在不同 Skill 中反复总结出类似的原则。rules-distill Skill 可自动扫描所有已安装的 Skills，提取出“被 2 个及以上 Skill 共同强调、具备可操作性的行为原则”，并建议追加到 Rules 体系中。

其工作流程包括：

全量扫描 Skills 和 Rules，聚合所有主题。
分批聚类，用 LLM 交叉比对，筛选出“可写成‘应做/不应做’的原则，且违反有明确风险”的候选项。
判定归属（追加、修订、新增、已覆盖、过于具体），并生成详细的 distillation 报告，供用户一键审核/应用/跳过。
结果持久化，所有变更均需人工确认，绝不自动修改规则文件。

详细用法见 Everything Claude Code Rules Distill Skill：扫描 Skills 提取跨项目原则并更新 Rules 文件库。

7. 典型应用场景举例

多语言项目：只需安装对应语言规则，所有 Agent/Skill 自动切换最优规范，无需反复提示。
团队规范升级：通过 rules-distill Skill，快速把团队在 Skills 实践中总结的新原则固化到 Rules，持续进化。
安全与合规：统一的安全基线（如密钥管理、输入校验、敏感操作防护）被自动注入到所有自动化流程。
AI 代码审查/生成/修复：所有 Agent（如 code-reviewer、build-error-resolver、tdd-guide 等）都能自动遵循最新规则，减少人工遗漏。

FAQ

Q: Rules 和 Skills 有什么本质区别？ A: Rules 定义“应该怎么做”的标准和清单，Skills 提供“怎么做”的具体方法和代码实现，两者协同提升 AI 编程助手的专业度。

Q: 可以只安装 common 规则，不装语言专属规则吗？ A: 可以，但建议根据实际项目技术栈按需安装专属规则，这样各语言 Agent/Skill 才能获得最优的本地化规范。

Q: rules-distill Skill 会自动修改我的规则文件吗？ A: 不会。所有规则变更都需要你人工审核确认，绝不自动覆盖，确保团队规范的可控演进。

Everything Claude Code Rules 体系详解：12 种语言规则集的设计思路与按需安装指南 ​

1. Rules 体系是什么？解决什么问题？ ​

2. Rules 的结构与设计思路 ​

3. Rules 的安装与按需激活 ​

推荐方式：一键安装脚本 ​

手动安装（进阶自定义） ​

4. Rules 与 Skills/Agents/Hooks 的关系 ​

5. 如何为新语言/领域扩展 Rules？ ​

6. 自动提炼跨项目原则：rules-distill Skill ​

7. 典型应用场景举例 ​

FAQ ​