计划路径校验器
对 /dr-plan 输出中的文件/脚本/路径引用进行存在性检查 — 在它们进入 /dr-do 之前标记缺失或已弃用的工具与文件引用。
概述
实施计划常常会指名具体的文件路径、脚本、工具和目录,作为编辑目标、回滚机制或支撑证据。当计划是凭记忆或过时的反思起草时,部分引用会指向自记忆形成以来已被重命名、移动或删除的路径。建立在幻影路径上的计划只会在 /dr-do 实施阶段才暴露缺陷 — 此时整个流水线阶段已经耗费 — 并迫使构建中途重新规划。本参考技能为 /dr-plan 输出所携带的路径引用提供确定性的存在性检查契约。它是 dr-plan § 6.5 中已规定的符号存在性检查的路径导向配套:符号存在性在代码中 grep 具名函数/标志/环境变量;路径存在性在文件系统(及 git 索引)中探测具名文件/脚本/目录,并额外标记可解析但被标记为已弃用的路径。
使用时机
当 /dr-plan 输出(或 PRD 中计划形态的章节)将某个文件路径命名为编辑/读取/回滚目标、由实施步骤或验证行调用的脚本或工具、被引用为目标或扫描根的目录,或在回滚策略、测试策略或验证清单中引用的支撑证据路径时,加载本技能。不适用于没有具体文件系统引用的纯概念性计划,或已由 dr-plan § 6.5 覆盖的仅符号引用。
契约
对于计划携带的每个路径引用,应用确定性的阶梯 — 不做 LLM 判断,不编造:
- 收集被引用的路径。 提取反引号、代码围栏或验证行命令中带斜杠的 token。去重。在传递给 shell 工具前,始终加引号并用
--终止选项解析(不可信输入卫生)。 - 存在性探测。 区分 git 跟踪路径与非 git 路径。在工作树内,优先使用
git cat-file -e HEAD:$p(已跟踪)或git ls-files --error-unmatch(已暂存但未提交),回退到test -e(未跟踪但存在)。在工作树外,直接使用test -e。未通过所有检查的 token 即为幻影路径。 - 弃用探测。 路径存在并不等同于当前有效。当路径或其最近的 README/index 带有 deprecated/retired/obsolete/superseded 标记、匹配已知退役的生态表面(引用事实来源行),或同级路径存在活跃替代品时,将已解析路径标记为已弃用。
- 报告。 输出紧凑块:检查数、存在数、MISSING 路径、带替代品的 DEPRECATED 路径 — 并入计划的验证清单或评审者的 QA 报告。
判定
- MISSING 路径是规划缺陷:将引用重定向到真实表面,或标记为
[to-be-created]并附一句理由。 - DEPRECATED 路径是陈旧缺陷:在计划执行前替换为活跃替代品。
- 全部存在、无弃用的结果是干净通过 — 无需更改计划。
与现有门禁的关系
补充 dr-plan § 6.5 的符号存在性检查(源代码符号)和 Git 拓扑探测(gitignored 与非 git 的区分,此处复用)。区别于 check-doc-refs.sh — 后者是 CI linter,在已提交文档上事后解析 markdown 链接 — 本技能在计划起草时对任何路径形态的 token 运行,早于 /dr-do。
反模式
- 凭记忆断言某路径已弃用而不引用事实来源行。
- 将符号存在性 grep 命中视为路径存在性通过。
- 对规划者输出的路径不加引号或不加
--运行test -e。