Communitygithub.com

landing-check — 變更是否確實生效,宣稱是否屬實?

一個由 FRESH 代理在提交前執行的工作檢查工具:驗證變更是否實際部署到執行中的檔案、書面宣稱是否與磁碟狀態一致、哪些內容本應移動卻未被移動,以及是否有任何私有資料洩漏到公開副本。僅供手動呼叫,永不自動觸發。

landing-check — 變更是否確實生效,宣稱是否屬實? 是什麼?

此技能名為 `landing-check`(或透過「did that land」、「check my work」等短語觸發),專為 AI 代理(如 Claude Code、Codex 等平台)設計,用於回答工具鏈中其他部分從未提出的三個問題:變更是否真正到達執行中的檔案?書面宣稱是否與磁碟上的實際狀態相符?本應隨之移動的項目是否被遺漏?它透過生成一個全新的代理來運作,該代理僅根據工件(git 狀態、差異、提交訊息、報告)進行推導,而不考慮作者自己的敘述,從而避免產生與原始錯誤相同的盲點。核心檢查涵蓋三個方面:(1) **部署檢查 (Landing)** — 驗證每個編輯的檔案是否是其執行中的副本(處理影子檔案、多樹結構、註冊表、啟用狀態);(2) **宣稱驗證 (Claims)** — 從工件中提取每個可檢查的斷言,並獨立地重新推導(優先處理全域性陳述、計數、狀態、數值及內部矛盾);(3) **附帶影響 (Collateral)** — 辨識應變更但未變更的項目(兄弟副本、修正傳播、文件、生成孿生體、副產品、洩漏)。一個可選的 `landing-probe.js` 機械式枚舉器可進行預處理,以協助代理而非讓其猜測。輸出簡潔,包含一個裁決行、覆蓋率行以及僅針對問題項目的表格。此技能對於捕捉以下情況至關重要:修正被部署到死檔案、報告宣稱在提交後立即變得過時,或跨儲存庫的「全域性」操作遺漏了某些副本。

相容平台✓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 檢查差異的正確性。/audit 對整個專案進行冷掃描。coding-conventions 要求作者重新執行自己的程式碼。三者都可能通過,但變更卻被放到一個不會被執行的檔案中,報告中的數字是錯的,而半數副本從未被觸及。

這個技能所要解決的失敗類型(在實務中觀察到): 一個安全性修正透過遍歷一組儲存庫中的每個 .git/hooks/pre-commit 檔案來部署。但其中幾個儲存庫設定了 core.hooksPath,Git 會因此完全忽略 .git/hooks——所以在部分儲存庫中,修正被放到了一個死檔案上,而實際的鉤子仍然使用舊的路徑。該迴圈確認了每次寫入,報告在六天內宣稱修正已全面部署。差異是正確的。驗證也是真實的。但兩者都指向了錯誤的檔案。

下方的每一項檢查都來自真實執行所需。沒有一項是推測性的——請參閱末尾的來源證明。在十次執行中:此掃描發現了零個程式碼錯誤,以及大約四十個虛假宣稱、部署錯誤的修正、失效的防護措施以及未能傳播的修正。這就是它能捕捉的問題類型。

觸發方式

/landing-check,或使用:「did that land」、「sweep the changes」、「verify what I just did」、「check my work before I commit」。僅供手動呼叫——因為它耗費一個代理,所以永遠不會自行觸發。

不屬於此技能的範圍

  • 差異中的程式碼正確性 → /code-review(內建;支援多代理和 --fix)。請勿在此重新審查邏輯。
  • 整個專案掃描 → /audit(冷掃描,昂貴)。
  • 重新執行你剛寫的內容 → coding-conventions(相同上下文,作者自己的視角,從 PostToolUse 鉤子觸發)。 如果某個發現屬於上述任一項,請標明並移交——不要將此技能擴充套件至它們。

如何執行

生成一個全新的代理(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. 部署檢查 — 編輯是否到達了實際執行的檔案?

對於每個變更的檔案,詢問是否存在另一個副本,以及是否有某種機制在它們之間進行選擇。特徵是:被編輯的檔案和實際執行的檔案名稱相同但路徑不同。

  • 影子化 (Shadowing):git config core.hooksPath(若設定 ⇒ .git/hooks/* 是死程式碼;使用 git rev-parse --git-path hooks/<name> 解析,這是 Git 自身使用的解析器)、PATH 環境變數中指令碼的順序、符號連結、node_modules 下的供應商副本、虛擬環境副本與儲存庫副本。
  • 多樹系統 (Multi-tree systems):如果一個檔案存在於多個樹中(已安裝/實驗室/公開、開發/發行、原始碼/構建),執行時載入的是哪一個?你所更改的是它嗎?
  • 註冊 (Registration):如果變更新增或編輯了某些必須被接入的內容(一個鉤子、一個排程任務、一條路由、一個入口點),請讀取註冊檔案並確認該路徑解析到你更改的檔案。
  • 啟用驗證 (Activation) — 正確的檔案是必要條件,而非充分條件。 對於任何屬於控制項的內容——一個防護、拒絕規則、鉤子匹配器、正規表示式、許可權模式、金絲雀斷言、忽略規則——請放入一個它存在是為了捕獲的正向案例並觀察它是否觸發,然後放入一個負向案例並觀察它是否保持靜默。一個從未被觀察到觸發的控制項是 UNVERIFIED。所有執行中發現的、被視為保護措施但卻無法觸發的控制項案例:無法阻止命令中間令牌的前綴匹配拒絕規則;一個其 \R 編譯成 X:Repo 而無法匹配真實路徑的洩漏正規表示式;一個區分大小寫的名稱過濾器,導致全大寫拼寫通過;一個永遠為真的斷言 /findings/.test(src)。
  • 每個變更檔案的裁決:LANDED / MISLANDED / UNVERIFIABLE(說明原因)。一個你無法確定其執行副本的檔案是 UNVERIFIABLE,而非 LANDED。遺留下來的死副本本身不是一個發現——請說明哪個副本是活的,以及編輯是在那個副本中。

2. 宣稱驗證 — 書面記錄與磁碟狀態相符嗎?

從工件中提取每一個可檢查的斷言,然後獨立地重新推導每一個——使用與產生該斷言不同的命令(如果存在不同的命令)。優先順序順序,由最高產出率開始:

  1. 全域性陳述 (Universals) — 「全部 7 個」、「每個副本」、「位元組完全相同」、「無一留存」、「0 個發現」、「所有 17 個儲存庫均無洩漏」。一個遺漏即可使整個陳述無效,而這正是產生 08-05 錯誤的類別。列舉完整集合並檢查每個成員;切勿將抽查視為全域性陳述的證據。一個你只能抽查的全域性陳述是 UNVERIFIED。
  2. 計數 (Counts) — 「17 條規則」、「29 項技能」、「21/21」。從資料來源計數,而不是從句子中獲取。注意時態:在條目內部計算的記錄條目計數,在條目落地的那一刻就會少一;從一個髒檔案內部做出的「唯一剩餘的髒檔案」宣告是自我否定的;引用一個尚不存在的條目指向的是虛無,直到它被寫入。
  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. 內部矛盾 (Internal contradiction) — 一個句子被其同一段落的五行程式碼之後的警告所否定;一個宣稱及其反駁同時存在且無日期戳記;同一個數字被引用三次且三次都錯。

一個你無法檢查的宣稱被報告為 UNVERIFIED,永遠不會被視為真。一個為真但出於不同原因的宣稱是一個發現。

3. 附帶影響 — 什麼應該移動卻沒有移動?

差異顯示了哪些內容變更了。這問的是變更所要求但未完成的事項。執行差異的逆運算:對於每個變更的值或概念,在整個樹中 grep 其他仍在使用舊值的地方。

  • 兄弟副本 (Sibling copies) — 每個持有相同檔案的其他樹/分支/套件。針對部署錯誤的修正本身在兩個副本中的一個中再次部署錯誤;將私有檔案大量複製到其公開孿生體上,重新引入了早期提交刻意移除的內容——將公開副本與其自身的 git show HEAD: 進行比較,而不是與私有來源比較。
  • 修正傳播 (Correction propagation) — 如果工作修正了一個宣稱,找到舊宣稱的每個其他副本:HANDOFF、PRD、記憶體箱、README、程式碼註解、公開孿生體、技能自身的描述。「已在記錄中修正,但 HANDOFF 和記憶體箱中仍保留舊數字」以及「此宣稱的第三個副本仍未刪除」是每次執行中最重複出現的發現。
  • 引用變更值的文件 (Docs quoting the changed value) — README、技能描述、HANDOFF、PRD、註解、MUST print N/N 固定值。程式碼中更改了計數但文件中未更改,這是一個發現。
  • 發布洩漏 — 部署到了不該去的地方。 如果任何被觸及的樹是公開的:掃描其差異(以及它所觸及的檔案相對於 HEAD 的差異)以尋找私有標識符——姓名、電子郵件、絕對路徑、私有專案名稱——不區分大小寫。說明此變更是引入了該字串還是繼承了它;兩者需要不同的修正,而且作者曾將前者誤認為後者。
  • 生成的孿生體 (Generated twins) — 記錄的渲染 HTML、目錄行、記憶體箱、錨點:已重新生成?一個可以解析但錯位一個標題的錨點不是「損壞的」,所以 broken: 0 並不能證明它完美。
  • 新增的工件類型 (New artifact types) — 工作是否建立了之前不存在的檔案類型(快取目錄、構建輸出、日誌)?是否存在忽略規則,以及它是否位於正確的儲存庫中?
  • 副產品 (Byproducts) — 建立並遺留下來的檔案:未追蹤的檔案、臨時目錄、__pycache__、.tmp、備份。列出它們及其完整路徑;不要刪除任何東西。
  • 文件所述的義務 (The obligation the docs state) — 如果專案自身的規則規定此類變更需要某些事項(記錄條目、重新生成的孿生體、同步的快照、測試執行、固定版本提升),請檢查它是否已完成。

探測 — 機械式前半部分,在代理進行判斷之前執行

landing-probe.js(可移植 Node.js,零依賴,唯讀)會列舉步驟 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。基於快取引用的 ahead N 無法證明任何事。

當有需要關注的內容時(一個 DEAD 鉤子、一個變更檔案的 DIFF 孿生體、一個 MISSING 註冊),退出碼為 1;對於一個乾淨的普查,退出碼為 0。它本身不做任何判斷——私有副本與其通用化的公開副本之間的 DIFF 是預期的,由代理來說明。--canary 會建立一次性儲存庫(hooksPath 已設定/未設定/指向不存在的位置、一個裸遠端和一個領先一個提交的克隆、CRLF 孿生體、一個常規名稱森林、一個包含一個缺失路徑的設定檔),並且必須列印 CANARY PASS 23/23 之後你才能信任普查結果。

輸出

簡短。這是一個提交前的健全性掃描,而非審計報告。

  • 裁決行:SAFE TO COMMIT / FIX FIRST / UNVERIFIABLE,一句話。
  • 覆蓋率行:讀取了哪些工件,掃描了哪些樹,以及什麼是 NOT SWEPT——一份簡短的報告絕不能讀起來像是一份乾淨的報告。
  • 部署表:file | copies found | which one executes | fired on a planted positive? | verdict。僅需為 MISLANDED 或 UNVERIFIABLE 的行提供詳細資訊。
  • 宣稱表:claim (quoted) | source artifact | re-derived result | TRUE / FALSE / UNVERIFIED。
  • 附帶影響列表:應該移動但未移動的項目,每個都帶有路徑。
  • 已確認事項:承載關鍵資訊的否定結果以及完全重現的數字(無部署錯誤、無洩漏、25/25 重現)——一個只報告錯誤的掃描無法說明哪些部分是穩固的,而作者的記錄需要它們。
  • 交接事項:任何屬於 /code-review、/audit 或 coding-conventions 的項目,在此標明並移交,而不是在此處半途而廢地處理。

報告之後

  • 在採取行動之前,手動重新驗證每個發現。 驗證者的宣稱本身就是宣稱:一次執行中重新推導的整數有誤,是因為語料庫在它執行時增長了;不變性保持不變。接受那些可以重現的結果。
  • 修正同樣需要回答這三個問題。 針對 FIX FIRST 發現的修正需要應用到每個副本以及每個引用舊值的文件——一個修正了兩個副本中一個部署錯誤的執行,其修正本身也只部署到了兩個副本中的一個。
  • 在最後一次驗證執行之後,根據重新推導的值撰寫記錄條目,而不是在此之前:先撰寫的條目記錄的是你預期的狀態,而僅附加的記錄會使該狀態永久化。

規則

  • 僅限發現。 不要提供建議、最佳實踐、或「可能也應該...」。只報告工件中明確的內容與可驗證的狀態之間的具體偏差。
  • 不要修復任何東西。 指出問題所在和原因;讓作者或後續工具來處理修正。
  • 如果代理無法完成掃描(例如,由於權限問題或無法解析註冊路徑),則報告 UNVERIFIABLE 並說明原因。
  • 來源證明:此技能中描述的每個檢查都源自真實事件,其中標準工具鏈未能捕捉到問題。在十次真實執行中,它發現了大約四十個非程式碼缺陷,這些缺陷會導致錯誤的安全假設、損壞的報告以及未能傳播的修正。這不是理論推導。

最後更新:2025 年 10 月。

相關技能