用途：在用户要求“update CLAUDE.md”“refresh CLAUDE.md”“sync CLAUDE.md with the codebase”等时使用，更新并优化项目根目录的 CLAUDE.md 及其 .claude/rules/*.md 主题文件，使其与代码库现实和各自最后一次提交以来的 git 历史保持一致。作用范围仅为项目 CLAUDE.md（L1）及其主题文件；用户全局 ~/.claude/CLAUDE.md（L0）不在范围内，除非用户明确要求。若项目根目录没有 CLAUDE.md，会告知创建不在本技能范围内并停止。
主要能力：强制渐进式披露——CLAUDE.md 作为项目身份、通用不变量和主题文件指针的顶层索引；.claude/rules/ 下的主题文件需带 paths: frontmatter，以便仅在其子系统文件被触及时加载，而非每次会话加载。审计主题文件的过时、准确性与重复问题，并处理 CLAUDE.md 与主题文件之间的悬空引用和未被引用的孤立主题文件。基于变更量、跟踪文件数计算扫描分片数 N（上限 4），并行运行 3+N 个 Explore 子代理：CLAUDE.md 与主题文件审计、逐文件 git 历史、代码库扫描分片。随后对每个段落分类为 keep、update、delete、demote→主题文件、promote→CLAUDE.md、move→其他主题文件、add、add-paths-frontmatter→glob；检查预算（CLAUDE.md 软目标约 120 行、软上限 150 行，主题文件信息性软上限约 300 行），用 AskUserQuestion 让用户批准全部、选择性批准或拒绝，再执行写入。
使用方式与写入顺序：先 cp CLAUDE.md CLAUDE.md.bak 备份，再按需 mkdir -p .claude/rules/，依次处理主题文件（删除、创建、编辑、回填 paths frontmatter），最后重写 CLAUDE.md 并重新生成末尾的 ## Topic Files 索引段；该索引每条是加载触发短语，不是描述性链接，且需与主题文件自身的 paths: glob 一致。多数内容不变时用 Edit，超过 60% 变化时用 Write。行数用 wc -l 测量。
适用场景：需要让项目级 Claude 指令文件与代码库同步、重组指令文件、拆分或合并主题文件的维护工作。
限制：不负责创建不存在的 CLAUDE.md；CLAUDE.md 的 150 行是唯一硬约束，超出时由用户决定是否接受；主题文件超出行数上限只标记、不强制拆分；top 3-5 个通用不变量永不降级；promote 回 CLAUDE.md 需谨慎使用，仅在内容变为几乎所有任务都需要的通用不变量时进行；不处理 CI、格式化和版本号提交。