用途:把 Claude Code 的持久上下文当作需治理的代理状态来审计,暴露过期、不安全、重复、过宽、冲突、错位或不可执行的条目,提出更合适的存放位置,并让审查、规划、持久化与清理走同一套明确契约。适用范围仅限 Claude Code 的上下文面:CLAUDE.md、CLAUDE.local.md、条件加载的 AGENTS.md、.claude/rules/、用户级规则、设置、钩子、托管策略证据以及自动记忆文件;不适用于 Codex、Cursor、Claude 网页/应用、Anthropic API Memory Stores 或通用提示工程。
主要能力:提供八个固定工作流(review-chat、review-file、cleanup-chat、cleanup-file、plan-cleanup-chat、plan-cleanup-file、plan-run-cleanup-file、plan-run-cleanup-chat),分别对应只读审查、审查加计划、以及带备份的清理与验证;对每条原子声明只给一个分类(如 KEEP、REWRITE、MOVE TO CLAUDE.md、MOVE TO CLAUDE RULE、MOVE TO SETTINGS、DELETE、ASK USER 等),并附风险标签、置信度与建议动作。
使用方式:先选定路由与目标范围,再盘点上下文而不导出内容,并运行只读风险扫描,例如:node scripts/inventory-claude-memory.mjs --repo . 和 node scripts/scan-claude-memory-risks.mjs --repo . --json(扫描退出码 1 表示发现项,而非执行失败)。涉及编辑前必须备份确切文件,可使用 node scripts/backup-claude-memory.mjs,并按需传 --include 等参数;备份与未脱敏清单须放在 Git 工作区之外。文件路由只持久化一份脱敏整理记录,聊天路由不落盘报告。
适用场景:CLAUDE.md 等上下文过期、冲突、含敏感信息、过宽或被忽略,导致 Claude 复用旧指引时的复查、定位、规划与清理。
限制:默认将托管策略(如 /etc/claude-code/CLAUDE.md、managed-settings.json)视为高优先级只读证据,除非有明确编辑授权;不擅自删除、重写或移动上下文文件;不输出完整密钥等敏感值;自动记忆结构不明时不得直接编辑;计划模式或权限未知时不得写入;直接清理仅限高置信度的原子改动,整文件删除、共享 AGENTS.md、新上下文文件、设置、钩子、托管策略等一律推迟;具体导出格式与更多细节以资料为准,未在此展开。