用途:在重命名技能、文件或标识符后,扫描并清理旧名称的残留引用。仅按词元 grep 通常只能覆盖 50–70%,其余隐藏在链式描述、逗号列表、编号表格行、frontmatter 链字符串、glob、跨技能模式引用和内容文件路径等形式中。该技能把“找出所有引用”变成一次调用,运行完整模式库并把匹配分为确定、链式上下文、歧义三类。
主要能力:支持审计(只读扫描)、audit blast(重命名前影响面计数)、audit half-rename(同时提及新旧名的文件)、audit orphans(重命名后遗留引用)、apply(执行重命名)、preview(试运行)和 blocklist(打印英文动词屏蔽列表)。提供 --include-historical、--include-memory、--include-plan-docs、--include-bare-token、--container、--identifier 等覆盖标志,长格式、位置无关,多个标志可组合。
使用方式:无参数时按显式参数、最近对话、git 重命名检测、git 状态启发式的优先级自动识别重命名对;也可显式传入,如 /rename-references <old> to <new>,分隔符可为 to、→、->、into。审计模式只跑前三个阶段并报告;预览模式跑到第四阶段但不做 Edit。应用模式流程为检测、调查、分类、确认、应用、重扫,重扫直到可操作计数为 0。
适用场景:技能或文件重命名中途、刚执行 git mv 后、提交 PR 前工作树含 R 状态文件时。
限制:不执行 AST 级重命名(如 Python 类名、C# 类型名、JS 函数重构);不重命名 git 分支;不处理框架版本迁移;不自动修改会话历史或记忆条目;不运行构建或测试;不做与具体重命名无关的通用死链扫描。
分类:编程与开发。