Communitygithub.com

ランディングチェック — 成果が適切に配置され、主張は正しいか?

FRESHエージェントによる作業後のスイープ:変更は実行されるファイルに適用されたか、書面上の主張はディスクと一致するか、変更に伴い更新されるべきものはすべて更新されたか、プライベートな情報が公開コピーに漏洩していないかをチェックします。手動でのみ呼び出され、自動発火はしません。「ランディングチェック」「ちゃんと配置された?」「作業を確認して」などで起動します。

ランディングチェック — 成果が適切に配置され、主張は正しいか? とは?

このスキルは、コードレビューやプロジェクト全体の監査など、既存のツールでは見落とされがちな、デプロイ後の変更の正確性を検証するためのものです。具体的には、以下の3つの質問に答えます:変更は実行時に実際に使用されるファイルに適用されたか(ランディング)、書かれたレポートやコミットメッセージの主張はディスクの実際の状態と一致するか(クレーム)、変更によって更新されるべき他の場所(ドキュメント、設定、他のコピー)が更新されたか(コラテラル)。このスキルは、特にセキュリティ修正がgitのフック設定の違いにより無効なファイルに適用された事例など、実際の障害事例に基づいて設計されています。現在のところ、コードのバグは見つけていませんが、誤った主張や不適切に適用された修正などの問題を多数発見しています。エージェントは、ユーザーによる主観的な要約ではなく、gitの状態や変更されたファイルなどの実際の成果物のみを基に検証を行い、クレームはすべて独立した方法で再導出されます。これは、FRESHエージェント、Claude Code、および同様のAIエージェントと連携するように設計されています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

landing-check — 作業は適切に配置されたか、そして主張は正しいか?

ツールチェーンの他の何も尋ねない3つの質問。/code-review は差分の正しさを読み取る。/audit はプロジェクト全体をコールドスイープする。coding-conventionsは作成者に自身のコードを再実行させる。これらすべてがパスしても、変更が何も実行されないファイルに適用されていたり、レポートに間違った数値が記載されていたり、コピーの半分が更新されていなかったりする可能性がある。

このスキルが存在するための障害クラス(実際に観測されたもの): セキュリティ修正が、リポジトリのセット内のすべての.git/hooks/pre-commitファイルをループすることでデプロイされた。しかし、それらのリポジトリのいくつかはcore.hooksPathを設定しており、gitは.git/hooks全体を無視する — そのため、いくつかのリポジトリでは、修正はデッドファイルに適用され、ライブフックは古いパスを維持し続けた。ループはすべての書き込みを確認し、レポートは修正が6日間普遍的であると断言した。差分は正しかった。検証は本物だった。両方とも間違ったファイルに関するものだった。

以下の各チェックは、実際の実行で必要だったものである。いずれも推測ではない — 末尾の「由来」を参照のこと。10回の実行で:このスイープはコードのバグをゼロ、誤った主張、誤って配置された修正、デッドガード、伝播しなかった修正を約40個発見した。それが捕捉するものの形状である。

トリガー

/landing-check、または:「ちゃんと配置された?」「変更をスイープして」「今やったことを確認して」「コミットする前に作業を確認して」。手動でのみ呼び出される — エージェントを消費するため、自動発火はしない。

このスキルの範囲外

  • 差分内のコードの正確性 → /code-review (ビルトイン;マルチエージェントと--fixを持つ)。ここでロジックを再レビューしないこと。
  • プロジェクト全体のスイープ → /audit (コールド、高コスト)。
  • 書いたばかりのものを再実行する → coding-conventions (同じコンテキスト、作成者自身の目、PostToolUseフックから発火)。 もし発見事項がこれらのいずれかに属する場合、それを指名して引き継げ — このスキルをそれらに肥大化させないこと。

実行方法

1つのFRESHエージェントを起動する (Agentツール、汎用)。コンテキストは控えめに:これはプロジェクト全体ではなく、変更されたものにスコープされる。

エージェントが取得するもの — 成果物のみ:

  • タッチされたリポジトリパス、およびプロジェクトが何であるかを示す1行;
  • git status + git diff (およびリポジトリごとのgit diff --stat) — または、非リポジトリツリーの場合は、このセッションで変更されたパスのリスト;
  • 作業の書かれた説明:コミットメッセージ、記録エントリ、最終レポートテキスト、変更を説明するために編集されたドキュメント;
  • タッチされたツリーのうち、PUBLIC(どこかにプッシュされたもの)がある場合は、その情報;
  • 以下の手順1~3と出力形式、および到達しなかったものには NOT SWEPT とマークする指示。

絶対に取得してはいけないもの:あなた自身の作業に関する説明。 主張自体が検体である。あなたの要約をエージェントに渡せば、あなたは同じ盲点をエージェントに渡すことになる — あなたは被告であり証人でもあることになる。エージェントは書かれた成果物とディスクからすべての主張を再導出する。これがこのスキルをコストに見合うものにする唯一のルールである。これを破れば、これは別窓での自己採点に過ぎなくなる。

エージェントは状態をライブで再読み取りする。 git status、ahead/behind、プッシュされたもの:これらは、渡されたキャプチャからではなく、スイープ時に導出される — 他のセッションがその間にコミット、プッシュ、編集を行う可能性がある(並行セッションが無関係なコミット内で修正をコミットした;6つのリポジトリが「プッシュはゼロ」と伝えられたスイープの数分前にプッシュされていた)。ahead Nは、最初にfetchがなければ何も証明しない — リモートに問い合わせる(git ls-remote、次にgit rev-list --left-right --count @{u}...HEAD)。

1. ランディング — 編集は実行されるファイルに到達したか?

変更されたすべてのファイルについて、別のコピーが存在するかどうか、および何かがそれらの間で選択しているかどうかを尋ねる。シグネチャは:編集されたファイルと実行されるファイルは同じ名前で異なるパスを持つ。

  • シャドウイング: git config core.hooksPath (設定されている場合、.git/hooks/*はデッドコード;git rev-parse --git-path hooks/<name>で解決、git自身が使用するリゾルバ)、スクリプトのPATH順序、シンボリックリンク、node_modules下のベンダーコピー、venvコピーとリポジトリコピー。
  • マルチツリーシステム: ファイルが複数のツリー(インストール済み/ラボ/公開、dev/dist、src/build)に存在する場合、ランタイムはどれをロードするのか?変更されたのはそれか?
  • 登録: 変更が配線が必要なもの(フック、スケジュールされたタスク、ルート、エントリポイント)を追加または編集する場合、登録ファイルを読み取り、そこでのパスが変更したファイルに解決されることを確認せよ。
  • 有効化 — 正しいファイルは必要十分条件ではない。 制御 — ガード、拒否ルール、フックマッチャー、正規表現、パーミッションパターン、カナリーアサーション、無視ルール — に対しては、それが捕捉するために存在するポジティブを植え付け、それが発火するのを見て、次にネガティブを植え付け、それが沈黙を保つのを見よ。発火が観測されなかった制御は UNVERIFIED である。保護として読み取られ、発火できなかった制御は、すべて実行で発見された:プレフィックスマッチャーであり、コマンド途中のトークンを決してブロックできない拒否ルール;\R が X:Repo にコンパイルされ、実際のパスにマッチできないリーク正規表現;大文字のスペルを通してしまうケースセンシティブな名前フィルター;/findings/.test(src) という、常に真であるアサーション。
  • 変更されたファイルごとの判定:LANDED / MISLANDED / UNVERIFIABLE (理由を述べよ)。実行コピーを決定できなかったファイルは、LANDEDではなくUNVERIFIABLEである。残されたデッドコピー自体は発見事項ではない — どのコピーがライブで、編集がその中にあるかを述べよ。

2. クレーム — 書かれた説明はディスクと一致するか?

成果物からチェック可能なすべてのアサーションを抽出し、次にそれぞれを独立して再導出する — 可能な場合は、それを生成したものとは異なるコマンドを使用する。優先順位、最も高い収穫から:

  1. 普遍的なもの — 「7つすべて」「すべてのコピー」「バイト単位で同一」「残っているものはない」「発見事項0」「17すべてのリポジトリにわたって何も漏洩していない」。1つの見落としが文全体を偽にし、これが08-05エラーを生み出したクラスである。完全なセットを列挙し、各メンバーをチェックせよ。スポットチェックを普遍的なものの証明として決して受け入れてはならない。スポットチェックしかできなかった普遍的なものはUNVERIFIEDである。
  2. カウント — 「17ルール」「29スキル」「21/21」。文からではなく、真実のソースからカウントせよ。時制に注意せよ:カウント対象内に書かれた記録エントリのカウントは、それが着地した瞬間に1ずれる;「唯一のダーティファイルは残っている」という主張がダーティファイル内からなされた場合、自己反証となる;まだ存在しないエントリの引用は、それが書かれるまでは何も指さない。
  3. 状態 — 「パス」「クリーン」「再生成された」「プッシュされた」。それを実行するか、それを証明する成果物を読め。引用された出力はプログラムに関する主張である:成果物が証拠としてツール出力の行を引用している場合、そのリテラルをツール内でgrepせよ — 失敗ブランチでのみ出力される行はパスの証拠にはならず、プログラムが決して出力しない行は捏造された引用である。
  4. 数値 — トレース元の出力よりも有効数字が多い値は捏造されたものである(2dpの表から4dpで公開された13のシェアカウント:12が間違い)。LIVEコーパス(トランスクリプト、ログ、成長する記録)からの統計は、コーパスの状態が固定されていなければ再現不可能である(ファイル数+タイムスタンプ);UNVERIFIED-AS-STATEDとして報告し、何が再現できるかを示せ。単一文内の算術をチェックせよ(「27足す3 … 今日は29」)。比較の場合:すべてのアームで同じサンプルセット、推定名、nの記載 — バッチを共有しないアームを持つ2x2は比較ではない。欠落したフィールドは false ではない。float32を経由して丸められるfloatに対する == は決してマッチせず、コミットされたJSONは真の0.605に対して0.0を保持していた。
  5. 内部矛盾 — 5行後の段落の注意書きによって反証される文;主張とその反論の両方が日付の取り消し線なしに存在する;同じ数字が3回引用され、すべて間違っている。

チェックできない主張は、真実としてではなく、UNVERIFIEDとして報告せよ。異なる理由で真実である主張は発見事項である。

3. コラテラル — 移動すべきだったが移動しなかったものは?

差分は何が変更されたかを示す。これは変更が義務付けたが未完了のまま残したものを尋ねる。差分の逆を実行せよ:変更された値や概念ごとに、ツリー内でまだ古いものを主張している他の場所をgrepせよ。

  • 兄弟コピー — 同じファイルを保持する他のすべてのツリー/ブランチ/パッケージ。ミスランディングの修正自体が2つのコピーのうち1つでミスランディングしている;プライベートファイルの公開ツインへの一括コピーが、以前のコミットで意図的に削除されたものを再導入している — 公開コピーを、プライベートソースではなく、自身のgit show HEAD:と比較せよ。
  • 修正の伝播 — 作業がクレームを修正する場合、古いクレームの他のすべてのコピーを見つけよ:HANDOFF、PRD、メモリビン、README、コードコメント、公開ツイン、スキル自身の説明。「記録では修正されたが、HANDOFFとビンは古い数値を示したまま」「このクレームの3番目のコピーはまだ取り消されていなかった」は、すべての実行で最も繰り返される発見事項である。
  • 変更された値を引用するドキュメント — README、スキル説明、HANDOFF、PRD、コメント、MUST print N/Nピン。コードで変更され、散文で変更されていないカウントは発見事項である。
  • 公開漏洩 — あってはならない場所に着地した。 タッチされたツリーのいずれかが公開の場合:その差分(およびタッチされたファイルをHEADと比較)を、プライベート識別子 — 名前、メールアドレス、絶対パス、プライベートプロジェクト名 — に対してケースインセンシティブにスイープせよ。この変更がその文字列を導入したのか、それとも継承したのかを述べよ;両者は異なる修正を必要とし、作成者は以前に前者を後者と呼んだことがある。
  • 生成された双子 — レコードのレンダリングされたHTML、目次行、メモリビン、アンカー:再生成されたか?解決するが1見出し早く着地するアンカーは「壊れた」ではないため、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分以内に修正されたファイルをNON-repoルート下で追加する(インストール済みツリーはリポジトリではない)。
  • TWIN — 変更されたファイルごとに、任意のルート下のすべての同名ファイル、SAME または DIFF (sha256、CRLF正規化)。慣例的な名前 (SKILL.md、README.md — 6コピーを超えるベース名) は名前のみではなく親ディレクトリ/名前でマッチする。--all は変更されたものだけでなく、すべてのツイングループをリストする。
  • REG — --settings <json>:すべてのパス形状の文字列(~/$HOME/%USERPROFILE%展開後)とそれが RESOLVES するかどうか。
  • REMOTE — リポジトリごとのahead/behind、ラベルは CACHED ref、ただし --remote が最初にフェッチした場合を除く。キャッシュされたrefからの ahead N は何も証明しない。

確認すべきものがある場合(DEADフック、変更されたファイルのDIFFツイン、MISSING登録)は終了コード1。クリーンなセンサスは0。これは何も判断しない — プライベートとその一般化された公開コピーの間の DIFF は期待され、エージェントがそう述べる。--canary は使い捨てリポジトリを構築し (hooksPath設定/未設定/何も指さない、ベアリモートと1コミット進んだクローン、CRLFツイン、慣例的な名前の森、1つの欠落パスを持つ設定ファイル)、センサスを信頼する前に CANARY PASS 23/23 を出力しなければならない。

出力

短く。これは監査レポートではなく、コミット前の健全性スイープである。

  • 判定行: SAFE TO COMMIT / FIX FIRST / UNVERIFIABLE、1文。
  • カバレッジ行: どの成果物が読まれたか、どのツリーがスイープされたか、そして何が NOT SWEPT か — 短いレポートは決してクリーンなものとして読まれてはならない。
  • ランディングテーブル: ファイル | 見つかったコピー | 実行されるもの | 植え付けられたポジティブで発火したか? | 判定。MISLANDEDまたはUNVERIFIABLEの行のみ詳細が必要。
  • クレームテーブル: クレーム (引用) | ソース成果物 | 再導出結果 | TRUE / FALSE / UNVERIFIED。
  • コラテラルリスト: 移動すべきだったが移動しなかったもの、それぞれパス付き。
  • 確認されたもの: 負荷のかかる否定と正確に再導出された数値 (ミスランディングなし、漏洩なし、25/25再現) — 障害のみを報告するスイープは、何が堅牢であるかについて何も教えず、作成者の記録はそれらを必要とする。
  • ハンドオフ: /code-review、/audit、または coding-conventions に属するものは、ここで中途半端にやるのではなく、名前付けて引き継げ。

レポート後

  • 行動する前に、すべての発見事項を手動で再検証せよ。 検証者の主張も主張である:ある実行の再導出された整数が、コーパスがその下で成長したためにずれていた;不変条件は保持されていた。再現するものを受け入れよ。
  • 修正も同じ3つの質問の対象となる。 FIX FIRST発見事項への修正は、すべてのコピーと古い値を引用するすべてのドキュメントに適用される — 2つのコピーのうち1つへのミスランディングを修正した実行は、修正を2つのコピーのうち1つに出荷した。
  • 記録エントリは、再導出された値から、最後の検証実行の後、その前ではなく、書け。 最初に書かれたエントリは、あなたが期待した状態を記録し、追記専用の記録はそれを恒久的にする。

ルール

  • 発見事項のみ。変更しないこと。 発見事項は発見事項として報告せよ。スキルは削除も修正も行わない — それは作成者の仕事である。FIX FIRST と SAFE TO COMMIT のみを報告せよ;重要度はない。
  • 読み取り専用のまま。 触れたものに書き込まないこと。landing-probe.js は読み取り専用である。このスキルは書き込みアクセスを持たない。
  • エージェントごとに1つの役割。 スイープエージェントはサーチャーであり、修正者ではない。その出力は作成者によって処理される。
  • 疑惑は発見事項として報告せよ。 証拠のない疑惑ではなく、発見事項からの推論。「不可能ではない」は発見事項ではない。
  • 確認されていないものは確認されたものとして報告してはならない。 UNVERIFIEDは『多分大丈夫』と解釈されてはならない — それを UNVERIFIED と呼べ。
  • 失敗を検索するが、成功を無視してはならない。 確認されたものセクションは、主張と発見事項に等しく重みを置く。すべてのスイープは、正しいものと間違っているものの両方を報告する。
  • 安易に確実と見なさないこと。 ファイルが存在することは、それが実行されることを証明しない。実行されることは、それが正しいコンテキストを持っていることを証明しない。実行されることは、それが書かれていることを実行することを証明しない。制御が on であることは、それがオフになることをできないわけではないことを証明しない (完全な sudo rm -rf / 保護は、rm がPATH内にないときにのみ発動する — 一度発動すれば、誰も保護がなくなったことに気づかないかもしれない)。

由来

上記のチェックは、単一のセッションにおける本番システムの実際のインシデントから派生している。そのセッションは:レースコンディション (フェッチ前の ahead/behind)、無視された設定 (hooksPath がフックファイルを無効にした)、偽のカウント (差の算術誤差)、自己反証 (記録エントリはそれがまだ存在しないにもかかわらず別のエントリを引用した)、ライブコーパス統計 (ソーステーブルから桁違い)、誤った比較 (共有されないバッチ)、UNVERIFIED のフック制御 (実際には決して発動しない拒否ルール)、記憶に基づく手動による検証 (間違っていた)、変更された値の伝播の欠如 (3番目のコピーは未更新)、複数の連続したミスランディング (修正が誤ったツインに出荷された)、蒸発する検証アーティファクト (二度と同じ実行はない)、行方不明の生成された双子 (一時ディレクトリが残された)。ツールはここに挙げたものを超える発見をしていない。各チェックは、それらのイベントのリスクを軽減するための適切なプローブを実装している。

このセッションの5時間のコンソールログ (スキーマからの生成、プロジェクトの記録、レビュー、および修正) は、landing-check スイープがもし存在していれば、レポートが記述された時点で最初のインシデントを捕捉し、修正ラウンド中に後続のインシデントも捕捉したであろうことを示している。

関連スキル