rules-architectlisted

# Rules Architect 规则架构 Skill > **中文** | [English](SKILL.en.md) Claude Code 的自我改进规则架构。安装 3 个核心 hook + 1 个 path-scoped rule + 维护文档，让规则归位变可靠，不再靠 CLAUDE.md 的 attention。 ## 它解决的问题 Claude Code 默认行为：所有细节都被甩到 L1 memory（因为 memory 是最方便写入的层）。结果是： - Memory 越堆越多，里面塞了大量本该放别处的规则 - 团队看不到你的 memory（私人） - CLAUDE.md 在长会话里 attention 稀释 - 本来应该 hook 拦截的规则留在 memory，结果继续被忘 本 skill 在**规则写入瞬间**提供 **3 层拦截**，自动触发归位重新评估。 ## 5 层记忆模型 | 层 | 是什么 | 触发 | token 开销 | |---|---|---|---| | **L0 hooks** | `~/.claude/hooks/*.py` + settings.json 配置 | 工具调用前/后，实时 | 启动 0，注入约 50-200 | | **L1 memory** | `~/.claude/projects/.../memory/*.md` | 每 session 注入索引，明细按需读 | 索引约 3k | | **L2 path-scoped** | `.claude/rules/*.md`，frontmatter 含 `paths:` | 编辑匹配文件时自动注入 | 启动 0 | | **L3 CLAUDE.md** | `CLAUDE.md` + `@import` 链 | session 启动全量加载 | 40k+ | | **L5 team lessons** | 仓库内 `docs/ai/lessons.md` | 人工或工作流触发读 | 0（按需） | ## 5 问归位 SOP 任何新规则**写入前**必走 5 问： | # | 问题 | 选层 | |---|---|---| | 1 | 触发条件能用 tool/matcher 精确表达？（如 "git commit"、"编辑 .proto"） | **L0 hook** 或 **L2 path-scoped** | | 2 | 只在编辑特定文件/目录时才用？ | **L2** `.claude/rules/` | | 3 | 全团队都要遵守（含 codex/gemini 用户）？ | **L3** CLAUDE.md 或 **L5** lessons | | 4 | 仅个人协作偏好，团队不需要知道？ | **L1** memory | | 5 | 与已有规则重叠？grep 关键词 → 是 → 改现有，别新建 | — | **禁止**：跳过 5 问直接默认落 L1 memory——这是泄漏的最大来源。 ## 默认流程：只读规则分布报告 用户在 Claude Code 运行 `/rules-architect`、在 Codex 运行 `$rules-architect`（或从 `/skills` 选择），或要求“整理规则”“显示规则分布建议”时， 默认生成**只读报告**，不先进入安装模式，也不修改任何规则文件。 **语言要求**：所有面向用户的对话、阶段更新、问题、建议摘要、归位原因和最终报告 必须使用中文。命令、文