用途:审计项目内所有 CLAUDE.md 及 .claude/rules/*.md,检查其内容是否与最近一段 git 历史发生漂移,即文档中引用了已删除文件、已重命名路径或已移除依赖。该技能为 fork 版本,只读运行,不会修改任何文件。
主要能力:
- 清点文档:用 find . -name "CLAUDE.md" -type f -not -path "/.git/" -not -path "/node_modules/" 列出所有 CLAUDE.md 及规则文件,并统计行数。
- 收集变更信号:通过 git log --since="$ARGUMENTS days ago" --name-status --no-merges --diff-filter=DR 获取删除与重命名路径;通过 git diff "@{$ARGUMENTS days ago}" --name-status -- package.json requirements.txt pyproject.toml go.mod Cargo.toml 获取依赖清单增删。
- 交叉比对:用 grep / Read 标记引用了已删除或重命名路径的行、Tech Stack / Dependencies 段落中引用了已移除依赖的行,以及 @path/... 链式导入或 markdown 链接指向已删除目标的行。
使用方式:调用时传入天数窗口参数($ARGUMENTS),为空则默认 7 天。按上述步骤顺序执行后,返回一份 markdown 待办清单,格式为 ## Drift Audit (window: <N> days),包含检查文件总数、检查的信号数量、Findings 列表(每条含位置、问题与建议动作)以及 Clean 部分;若无漂移,则仅返回 ## Drift Audit\n\nNo drift in <N>-day window. <count> files inspected.,不额外填充内容。
适用场景:维护 CLAUDE.md 等 AI 上下文文档的仓库,在重构、重命名文件或调整依赖后,快速发现文档与代码不一致之处。
限制:仅做只读审计,不自动修复;依赖 git 历史与本地仓库状态;依赖清单检查仅覆盖 package.json、requirements.txt、pyproject.toml、go.mod、Cargo.toml;具体安装方式与平台支持暂未提供。