Communitygithub.com

landing-check — 变更是否落地,声明是否属实?

在提交前进行的一次全面性检查:变更是否真正落到了执行的代码中,书面声明是否与磁盘状态一致,哪些内容应该被修改但却没有改动,以及是否有机密信息泄露到了公开副本中。仅手动调用,不会自动触发。触发词:/landing-check, 'did that land', 'check my work'。

landing-check — 变更是否落地,声明是否属实? 是什么?

`landing-check` 是一个面向 AI 代理技能(如 Claude Code、Cursor)的审查技能,专门用于捕获传统代码审查或自动化流程遗漏的一类系统性错误:**变更没有落在实际执行的代码上**。该技能强调“条文主义”——从不相信作者对工作的总结,而是要求代理严格基于 written artifacts(提交信息、报告文本、磁盘状态、git 输出)重新推导所有声明。它包含三个核心检查:Landing(检查变更是否真正到达执行的副本)、Claims(对照磁盘验证书面声明的准确性:全局声明、计数、状态、数字、内部矛盾)、Collateral(查找应该随变更移动或更新的所有副本、文档、公开泄露)。此外,它提供一个可选的 Node.js probe 脚本,用于机械性地枚举 hooks 影子问题、文件对等体、注册路径和远程状态,减少代理的猜测。该技能需要生成一个独立的代理实例,并严格遵守“不提供作者自己的总结”的规则,以打破认知盲区。它被设计为预提交的理智检查,其输出强调简洁,并包含“确认项”部分以平衡负面发现的偏见。已记录了多次实际运行中发现近 40 条错误声明、错位修复和未传播的修正。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Evan-Daruwalla/claude-skill-suite/tree/HEAD/landing-check

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

landing-check — 工作是否落地,声明是否属实?

三个问题,工具链中其他技能都不会问。/code-review 读取 diff 以检查正确性。/audit 对整个项目进行冷扫。coding-conventions 让作者重新运行他们自己的代码。这三个都可能通过,但变更却落到了一个什么也不执行的文件上,报告给出一个错误的数字,而一半的副本从未被触及。

此技能旨在捕获的实际观察到的失败类别: 一个安全修复通过遍历一组仓库中的每个 .git/hooks/pre-commit 文件进行部署。但其中一些仓库设置了 core.hooksPath,git 随后完全忽略 .git/hooks —— 因此在某些仓库中,修复落到了一个死文件上,而实时 hook 仍然使用旧路径。循环确认了每次写入,报告断言修复在六天内是通用的。diff 是正确的。验证是真实的。两者都是关于错误的文件。

下面的每个检查都是一次真实运行所需要的。没有一个是推测性的 —— 请参阅末尾的 Provenance。运行十次后:该扫描发现了零个代码 bug,以及大约 40 个错误声明、错位的修复、失效的保护措施和未传播的修正。这就是它捕获的内容的形态。

触发方式

/landing-check,或者:“did that land”、“sweep the changes”、“verify what I just did”、“check my work before I commit”。仅手动调用 —— 它消耗一个代理,因此永远不会自行触发。

不属于此技能

  • diff 中的代码正确性 → /code-review(内置;支持多代理和 --fix)。不要在这里重新审查逻辑。
  • 全项目扫描 → /audit(冷且昂贵)。
  • 重新运行你刚写的内容 → coding-conventions(相同上下文,作者自己的眼光,从 PostToolUse hook 触发)。 如果某个发现属于上述之一,请命名它并移交出去 —— 不要将此技能扩展到它们之上。

如何运行

生成一个全新的代理(Agent 工具,通用用途)。适中的上下文:范围限定在变更的内容,而不是整个项目。

代理得到的内容 —— 仅限工件:

  • 接触到的仓库路径,以及对项目的一句话描述;
  • git status + git diff(以及每个仓库的 git diff --stat)—— 或者,对于非仓库的目录树,本次会话修改的路径列表;
  • 工作的书面记录:提交信息、记录条目、最终报告文本、任何为描述变更而编辑的文档;
  • 接触到的哪些目录树是公开的(已推送到任何地方),如果有的话;
  • 步骤 1-3 和下面的输出格式,以及指令:标记任何它未触及的内容为 NOT SWEPT。

它绝不能得到的内容:你对所做工作的总结。 声明就是标本。如果你向代理提供你的总结,你就等于提供了产生错误的同一个盲点 —— 你同时成为被告和证人。它必须从书面工件和磁盘重新推导出每个声明。这是让技能值得其成本的唯一规则;放弃它,这就变成另一个窗口中的自我打分。

代理实时重新读取状态。 git status、ahead/behind、推送了什么:在扫描时推导,而不是从传递给它的捕获中 —— 其他会话在此期间可能已提交、推送和编辑(一个并发会话已在一个无关的提交内提交了一个修复;六个仓库在扫描前几分钟被推送,而扫描被告知“零次推送”)。ahead N 在没有先执行 fetch 的情况下证明不了什么 —— 请询问远程(git ls-remote,然后 rev-list --left-right --count @{u}...HEAD)。

1. 落地(LANDING)—— 编辑是否到达了实际运行的代码?

对于每个已更改的文件,询问是否存在另一个副本,以及是否有东西在它们之间进行选择。其标志是:编辑的文件和执行的文件有相同的名称,但不同的路径。

  • 影子(Shadowing):git config core.hooksPath(已设置 ⇒ .git/hooks/* 是死代码;使用 git rev-parse --git-path hooks/<name> 解析,这是 git 自身使用的解析器)、PATH 顺序(针对脚本)、符号链接、node_modules 下的供应商副本、venv 副本对比仓库副本。
  • 多目录树系统:如果一个文件存在于多个目录树中(已安装的/实验室/公开的,开发/部署,源码/构建),运行时加载的是哪一个?更改的是它吗?
  • 注册(Registration):如果变更添加或编辑了需要被连接起来的内容(hook、计划任务、路由、入口点),读取注册文件并确认其中的路径解析为你更改的文件。
  • 激活 —— 正确的文件是必要条件,但不是充分条件。 对于任何作为控制项的内容 —— 守卫、拒绝规则、hook 匹配器、正则表达式、权限模式、Canary 断言、忽略规则 —— 植入它本来要捕获的正向示例并观察它是否触发,然后植入负向示例并观察它是否保持沉默。从未被观察到触发的控制项是 UNVERIFIED。所有运行中发现的所有被读取为保护项但无法触发的控制项:无法阻止命令中间 token 的前缀匹配器拒绝规则;一个编译后为 X:Repo 且无法匹配真实路径的泄露正则表达式;一个区分大小写的名称过滤器放过了全大写拼写;一个 /findings/.test(src) 断言始终为真。
  • 每个已更改文件的判定:LANDED / MISLANDED / UNVERIFIABLE(说明原因)。无法确定其执行副本的文件是 UNVERIFIABLE,而不是 LANDED。遗留的死副本本身不是发现 —— 请说明哪个副本是活的,并且编辑在其中。

2. 声明(CLAIMS)—— 书面记录与磁盘一致吗?

从工件中提取每个可检查的断言,然后独立地重新推导每个断言 —— 使用与产生它的命令不同的命令(如果存在不同命令的话)。优先级顺序,最高产出的优先:

  1. 全称量词(Universals) —— “全部 7 个”、“每个副本”、“字节相同”、“无剩余”、“0 个发现”、“在全部 17 个仓库中无泄露”。一个遗漏就足以否定整个陈述,而这是产生 08-05 错误的类别。枚举完整集合并检查每个成员;切勿将抽查视为全局性陈述的证明。你只能抽查的全局性陈述是 UNVERIFIED。
  2. 计数(Counts) —— “17 条规则”、“29 个技能”、“21/21”。从真实来源计数,而不是从句子本身。注意时态:在被计数的条目内部写入的条目计数,在它落地的瞬间就少了 1;在脏文件内部做出的“唯一剩余的脏文件”声明是自相矛盾的;引用一个尚不存在的条目指向的是空。
  3. 状态(States) —— “通过”、“干净”、“已重新生成”、“已推送”。运行它,或读取证明它的工件。引用的输出是关于程序的一个声明:如果一个工件引用一行工具输出作为证据,用 grep 在工具中搜索该字面量 —— 只在失败分支上打印的行不能作为通过的证据,而程序从未发出的行是伪造的引用。
  4. 数字(Numbers) —— 一个比其来源输出具有更多有效数字的值是编造的(从 2 位小数的表格发布的 13 个份额计数,4 位小数:12 个错误)。来自实时语料库(转录、日志、增长中的记录)的统计数据,如果不固定其语料库状态(文件计数 + 时间戳)就无法复现;将其报告为 UNVERIFIED-AS-STATED 并命名确实可以复现的内容。检查一个句子内的算术(“27 加 3 … 今天 29”)。对于比较:每个分支的样本集相同,估计器命名,n 值说明 —— 分支之间不共享批次的 2×2 不是比较。缺失的字段不是 false。在 float32 中往返转换后的 == 比较浮点数从未匹配,提交的 JSON 中对于真正的 0.605 写了 0.0。
  5. 内部矛盾 —— 一个句子被其同一段落五行的免责声明所否定;一个声明及其反驳同时存在且没有注明日期的划除;同一个数字被引用三次,每次都错。

一个你无法检查的声明被报告为 UNVERIFIED,绝不作为真。一个为真但理由与陈述不同的声明是一个发现。

3. 附带内容(COLLATERAL)—— 什么应该移动却没有移动?

Diff 显示哪些内容发生了变化。这询问的是变更要求了什么但留下了未完成。执行 diff 的逆操作:对于每个已更改的值或概念,在目录树中 grep 其他仍然断言旧值的位置。

  • 兄弟副本 —— 每个其他包含同一文件的目录树/分支/包。对一个错位修复的修复本身在一份副本中又错位了;一个私有文件被整体复制到其公共副本上,重新引入了先前提交故意移除的内容 —— 将公共副本与其自身的 git show HEAD: 进行比较,而不是与私有源进行比较。
  • 修正传播 —— 如果工作修正了一个声明,找到旧声明的每个其他副本:HANDOFF、PRD、memory bins、README、代码注释、公共副本、技能本身的描述。“在记录中修正,但 HANDOFF 和 memory bin 中仍保留着旧数字”以及“该声明的第三份副本仍未划除”是每次运行中最反复出现的发现。
  • 引用已更改值的文档 —— README、技能描述、HANDOFF、PRD、注释、MUST print N/N 引脚。代码中已更改的计数,但在说明中未更改,这是一个发现。
  • 发布泄露 —— 落到了它绝不能落的地方。 如果任何接触到的目录树是公开的:扫描其 diff(以及它所接触的文件,与 HEAD 对比)以查找私人标识符 —— 姓名、电子邮件、绝对路径、私人项目名称 —— 不区分大小写。说明此变更引入了该字符串还是继承了它;两者需要不同的修复,并且作者以前曾将第一种误认为是第二种。
  • 生成的双胞胎 —— 记录的渲染 HTML、TOC 行、memory bins、锚点:是否已重新生成?一个解析成功但位置偏移一个标题的锚点不是“损坏的”,所以 broken: 0 不能证明它。
  • 新工件类型 —— 工作是否创建了以前不存在的文件类型(缓存目录、构建输出、日志)?是否存在忽略规则,并且是否在正确的仓库中?
  • 副产品 —— 创建并遗留的文件:未跟踪文件、临时目录、__pycache__、.tmp、备份。列出它们及其完整路径;不要删除任何内容。
  • 文档规定的义务 —— 如果项目自己的规则规定此类变更需要某些内容(记录条目、重新生成的双胞胎、同步的快照、测试运行、引脚提升),检查它是否已经发生。

探测脚本 —— 机械性部分,在代理判断之前运行

landing-probe.js(可移植 Node,零依赖,只读)枚举步骤 1-3 原本需要手动重新推导的内容,因此代理读取的是普查结果而不是猜测。为其提供每个接触到的目录树;将其输出作为工件交给代理。

node landing-probe.js probe <root>... [--file <p>]... [--since <min>]
                           [--settings <json>] [--remote] [--all]
node landing-probe.js --canary
  • HOOK —— 每个仓库,每个钩子:git 将要运行的文件(git rev-parse --git-path,遵守 core.hooksPath)以及另一位置中的任何 DEAD 副本;注册路径但无文件是 MISSING。
  • CHANGED —— 每个仓库的暂存/修改/未跟踪文件;--file 命名任何仓库外部的文件;--since N 在非仓库根目录(已安装的目录树不是仓库)下添加最后 N 分钟内修改的文件。
  • TWIN —— 对于每个已更改的文件,在任何根目录下的每个同名文件,SAME 或 DIFF(sha256,CRLF 标准化)。常规名称(SKILL.md、README.md —— 任何超过 6 个副本的基本名)按父目录/名称匹配,而不仅仅是名称。--all 列出每个孪生组,而不仅仅是已更改的。
  • REG —— --settings <json>:每个路径形状的字符串(在 ~/$HOME/%USERPROFILE% 展开后)以及它是否 RESOLVES。
  • REMOTE —— 每个仓库的 ahead/behind,除非先用 --remote 获取,否则标记为 CACHED ref。基于缓存 ref 的 ahead N 证明不了什么。

当有需要注意的内容(DEAD 钩子、已更改文件的 DIFF 孪生、MISSING 注册)时退出码为 1;干净的普查退出码为 0。它不做任何判断 —— 私有副本与其通用化公共副本之间的 DIFF 是预期的,代理会这么说。--canary 构建一次性仓库(设置了/未设置/指向无处的 hooksPath、裸远程和一个领先一个提交的克隆、CRLF 孪生、常规名称森林、一个包含一个缺失路径的设置文件),并且必须打印 CANARY PASS 23/23 才能信任普查。

输出

简短。这是一个预提交的理智检查,而不是审计报告。

  • 判定行:SAFE TO COMMIT / FIX FIRST / UNVERIFIABLE,一句话。
  • 覆盖率行:读取了哪些工件,扫描了哪些目录树,以及什么是 NOT SWEPT —— 一份简短报告绝不能读起来像一份干净的报告。
  • 落地表:文件 | 找到的副本 | 哪个执行 | 在植入的正向示例上触发了? | 判定。只有 MISLANDED 或 UNVERIFIABLE 的行才需要详细信息。
  • 声明表:声明(引用) | 来源工件 | 重新推导的结果 | TRUE / FALSE / UNVERIFIED。
  • 附带清单:什么应该移动但没有移动,每个都有路径。
  • 确认项:没有发现问题的不出错的否定项以及精确重新推导出的数字(无错位、无泄露、25/25 复现)—— 只报告故障的扫描无法说明什么是可靠的,且作者的记录需要它们。
  • 移交:任何属于 /code-review、/audit 或 coding-conventions 的发现,在此命名并传递过去,而不是半途而废地处理。

报告之后

  • 在采取行动之前,逐个手动重新验证每个发现。 验证者的声明也是声明:一次运行的重新推导整数出错是因为语料库在运行期间增长了;不变量仍然成立。接受可复现的内容。
  • 修复也需要回答同样的三个问题。 对 FIX FIRST 发现的修复需要应用到每个副本以及每个引用旧值的文档 —— 一次修复了一个两个副本中错位的修复,但只将修复部署到了两个副本之一。
  • 在最后一次验证运行之后,从重新推导的值编写记录条目,而不是在此之前:先编写的条目记录了您预期的状态,而仅追加的记录会使其永久化。

规则

  • 仅限发现。不进行变更。 不创建文件、不编辑文件、不修复代码、不运行测试、不提交。仅报告。
  • 绝不相信作者。 你是冲着工件和磁盘来的。如果作者说“这是全部 7 个”,那就找到全部 7 个,检查全部 7 个,然后报告结果。如果作者说“零个脏文件”,则运行 git status 并报告输出。给定的”与“实际的”之间的每个差异都是一个发现。
  • 你的输出不会被编辑。 移交不会过滤结果。见上面“报告之后”:作者会手动重新验证。
  • 绝不假设存在一组固定的仓库。 git status 告诉你在哪里。
  • 绝不信任缓存的值。 文档中的硬编码数字、git 输出中引用的计数、memory bin 中记录的目录 —— 运行的命令行。检查数字钱行的来源。
  • 如果你不能验证一个声明,报告 UNVERIFIED。 不要说“看起来正确”,不要说“可能是真的”,不要说“可能没问题”。

来源

此技能从一个事实上的失败演变而来:一个安全修复作为批量脚本部署,遍历一组仓库中的 .git/hooks/pre-commit,但其中一些仓库设置了 core.hooksPath —— 因此修复落到了一个死文件上,而实时钩子从未被触及。脚本确认每个写入成功;报告断言“所有 17 个仓库现在都已经打了补丁”。差异是正确的。一切看起来都很好。但环形缓冲区没有接收到事件,在 6 天后才被发现。手动输入的命令 git rev-parse --git-path hooks/pre-commit 揭示了不匹配。

没有检查着陆。没有检查声明。没有检查附带内容。这三个检查现在都有了。

(PS:作者打算在适当的时候记录的那个 6 天的窗口,如果着陆检查存在的话可能是零。)

相关技能