用途:审计并改进 Claude Code 的记忆文件,包括 CLAUDE.md、.claude/rules/*.md 路径作用域规则和配套的 code_map.md 导航图,使后续会话获得简洁、准确、可叠加的项目指令和快速代码检索入口。默认报告优先:先输出质量报告与拟议 diff,用户明确要求实施已批准方案时才直接编辑并验证;若用户已指定单处小改动,可走快速路径直接修改。
主要能力:发现并分类范围内的记忆文件(项目根、嵌套子树、路径作用域规则、个人覆盖、根/嵌套代码图、用户全局、托管策略);对照仓库验证命令、目录结构、@import 目标、rules 的 paths 通配符、与 .claude/settings.json 权限的一致性;按叠加分层清晰度、可执行命令、架构路由、工具权限与安全、工作流契合、简洁时效六项打分(满分100,A-F 分级);评估是否应新建嵌套 CLAUDE.md 或改用路径作用域规则;输出质量报告后再做定向更新。
关键语义:Claude Code 记忆文件是叠加分层而非目录覆盖,会话启动时从文件系统根到工作目录逐层加载并拼接;子目录文件在会话中读取该目录文件时惰性加载,兄弟目录不加载;@path 导入在启动时展开(递归最多4层),不节省上下文;块级 HTML 注释注入前被剥离;带 paths: 前置元数据的 .claude/rules/*.md 仅在匹配文件被读取时加载。官方建议每个 CLAUDE.md 控制在 200 行以内。
使用方式:按发现、取证、质量评估、先报告后编辑、定向更新、验证六阶段执行。发现命令示例:find . ( -name CLAUDE.md -o -name CLAUDE.local.md -o -name code_map.md ) -not -path './.git/' -not -path './node_modules/';验证使用 git diff --check。更新时保留钩子标记块(如 OMX:RUNTIME:START/END)与 @AGENTS.md 导入桥,用散文引用 ./code_map.md 而非 @code_map.md。
适用场景:迁移 Codex AGENTS.md 指令、根文件臃肿需拆分、嵌套子树需要本地指令、路径规则配置、代码图覆盖检查。
限制:不编辑用户全局 ~/.claude/CLAUDE.md 和托管策略文件(除非明确要求);不读取 CLAUDE.local.md 内容,仅确认其被 gitignore;不重复 .claude/settings.json 的硬权限规则;具体模板与评分细则见其 references 文件,本资料未提供完整内容。