Communitygithub.com

landing-check — 작업이 제대로 반영되었는가, 그리고 주장이 사실인가?

작업 변경 사항이 실제 실행되는 파일에 도달했는지, 작성된 보고서와 디스크 상태가 일치하는지, 그리고 변경 사항이 전파되어야 할 곳에 누락된 것은 없는지 확인합니다. `/landing-check`로 호출하며, 절대 자동 실행되지 않습니다.

landing-check — 작업이 제대로 반영되었는가, 그리고 주장이 사실인가?란 무엇인가요?

이 스킬은 일반적인 코드 리뷰나 감사 도구가 놓치는 실패 모드인 '변경 사항은 맞지만 적용 대상이 잘못된 경우'를 잡기 위해 설계되었습니다. diff의 정확성만 확인하는 `/code-review`, 전체 프로젝트를 냉정하게 스캔하는 `/audit`, 작성자의 코드를 재실행하는 `coding-conventions`와 달리, 이 스킬은 변경된 파일이 실제로 실행되는 파일과 일치하는지(LANDING), 작성된 주장이 디스크 상태와 일치하는지(CLAIMS), 그리고 변경으로 인해 영향을 받아야 할 다른 파일들이 누락되지 않았는지(COLLATERAL)를 세 가지 관점에서 검증합니다. 실제 운영 환경에서 발생한 보안 패치가 `core.hooksPath` 설정으로 인해 죽은 파일에 적용된 사례를 교훈으로 삼아 개발되었으며, 현재까지 코드 버그는 발견하지 못했지만 약 40건의 허위 주장, 잘못 적용된 수정, 죽은 가드, 전파되지 않은 수정 사항을 찾아냈습니다. 에이전트 비용이 많이 들기 때문에 사용자가 명시적으로 호출할 때만 작동하며, 검증 대상의 주장을 에이전트에 직접 전달하지 않고 기록된 산출물과 디스크 상태로부터 독립적으로 재도출하는 것이 핵심 규칙입니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

landing-check — 작업이 제대로 반영되었는가, 그리고 주장이 사실인가?은(는) 무엇을 하나요?

다른 도구 체인에서는 묻지 않는 세 가지 질문입니다. /code-review는 diff의 정확성을 읽습니다. /audit는 전체 프로젝트를 냉정하게 스캔합니다. coding-conventions는 작성자가 자신의 코드를 다시 실행하도록 만듭니다. 이 세 가지 모두 통과할 수 있지만, 변경 사항이 아무것도 실행되지 않는 파일에 적용되었거나, 보고서에 잘못된 숫자가 기재되었거나, 복사본의 절반이 전혀 수정되지 않았을 수 있습니다.

이 스킬이 존재하는 실패 유형 (실제 사례에서 관찰됨): 여러 저장소의 .git/hooks/pre-commit 파일을 반복하여 보안 수정 사항이 배포되었습니다. 그러나 일부 저장소는 core.hooksPath를 설정했고, git은 .git/hooks를 완전히 무시합니다. 따라서 일부 저장소에서는 수정 사항이 죽은 파일에 적용되었고, 실제 활성화된 훅은 이전 경로를 유지했습니다. 루프는 모든 쓰기 작업을 확인했고, 보고서는 수정 사항이 6일 동안 보편적으로 적용되었다고 주장했습니다. diff는 정확했습니다. 검증은 실제로 이루어졌습니다. 둘 다 잘못된 파일에 대한 것이었습니다.

아래의 모든 검사는 실제 실행에서 필요했던 것입니다. 그 어떤 것도 추측이 아닙니다. 끝부분의 출처를 참조하세요. 10회 실행 결과: 이 스캔은 코드 버그 0개와 약 40건의 허위 주장, 잘못 적용된 수정, 죽은 가드, 그리고 전파되지 않은 수정 사항을 발견했습니다. 이것이 이 스킬이 잡아내는 것의 모양입니다.

트리거

/landing-check, 또는: "그게 반영됐나", "변경 사항을 스캔해줘", "방금 한 작업을 확인해줘", "커밋하기 전에 내 작업을 확인해줘". 명시적으로만 호출됩니다. 에이전트 비용이 들기 때문에 절대 자동으로 실행되지 않습니다.

이 스킬이 아닌 것

  • diff의 코드 정확성 → /code-review (내장; 멀티 에이전트 및 --fix 지원). 여기서 로직을 재검토하지 마십시오.
  • 전체 프로젝트 스캔 → /audit (냉정하고, 비용이 많이 듭니다).
  • 방금 작성한 코드 재실행 → coding-conventions (동일한 컨텍스트, 작성자 자신의 눈, PostToolUse 훅에서 실행됨). 발견 사항이 위 중 하나에 속한다면, 이름을 지정하고 넘기십시오. 이 스킬을 그 영역으로 확장하지 마십시오.

실행 방법

하나의 새로운 에이전트를 생성하십시오 (Agent 도구, 범용). 컨텍스트를 적당히 유지하십시오. 이는 프로젝트 전체가 아닌 변경된 범위로 한정됩니다.

에이전트가 받는 것 — 산출물만:

  • 수정된 저장소 경로와 프로젝트가 무엇인지에 대한 한 줄;
  • git status + git diff (및 저장소별 git diff --stat) — 또는 저장소가 아닌 트리의 경우, 이 세션에서 수정된 경로 목록;
  • 작업에 대한 서면 기록: 커밋 메시지, 기록 항목, 최종 보고서 텍스트, 변경 사항을 설명하기 위해 편집된 문서;
  • 수정된 트리 중 공개된(어디든 푸시된) 것이 있다면 그 목록;
  • 아래 1-3단계와 출력 형식, 그리고 도달하지 못한 것은 스캔되지 않음으로 표시하라는 지시.

반드시 주지 말아야 할 것: 당신이 한 작업에 대한 요약. 주장이 검체입니다. 에이전트에게 당신의 요약을 넘기면, 오류를 발생시킨 바로 그 사각지대를 함께 넘겨주는 것입니다. 당신은 피고인이자 증인이 됩니다. 에이전트는 모든 주장을 서면 산출물과 디스크에서 다시 도출합니다. 이것이 이 스킬을 비용 가치 있게 만드는 유일한 규칙입니다. 이 규칙을 어기면, 이는 두 번째 창에서 스스로 채점하는 것에 불과합니다.

에이전트는 실시간 상태를 다시 읽습니다. git status, ahead/behind, 푸시된 것: 스캔 시점에 도출되며, 전달받은 캡처 시점이 아닙니다. 다른 세션에서 커밋, 푸시 및 편집이 그 사이에 발생할 수 있습니다 (동시 세션이 관련 없는 커밋 내에서 수정 사항을 커밋했거나, "푸시 0회"라고 알려진 스캔 몇 분 전에 6개 저장소가 푸시됨). ahead N은 먼저 fetch 없이는 아무것도 증명하지 못합니다. 원격에 물어보십시오 (git ls-remote, 그 다음 rev-list --left-right --count @{u}...HEAD).

1. 반영(LANDING) — 편집 내용이 실제 실행되는 파일에 도달했는가?

변경된 모든 파일에 대해, 다른 복사본이 존재하는지, 그리고 어떤 것이 그들 사이를 선택하는지 물어보십시오. 특징은 다음과 같습니다: 편집된 파일과 실행된 파일의 이름은 같지만 경로가 다릅니다.

  • 섀도잉: git config core.hooksPath (설정됨 ⇒ .git/hooks/*는 죽은 코드입니다; git rev-parse --git-path hooks/<name>으로 확인하십시오. git 자체가 사용하는 해석기입니다), 스크립트의 PATH 순서, 심볼릭 링크, node_modules 아래의 벤더 복사본, venv 복사본 대 저장소 복사본.
  • 다중 트리 시스템: 파일이 두 개 이상의 트리(설치됨 / 실험실 / 공개, 개발 / 배포, 소스 / 빌드)에 존재하는 경우, 런타임은 어떤 것을 로드합니까? 변경된 것이 그것입니까?
  • 등록: 변경 사항이 연결되어야 하는 것(훅, 예약된 작업, 경로, 진입점)을 추가하거나 편집하는 경우, 등록 파일을 읽고 그 경로가 변경한 파일을 가리키는지 확인하십시오.
  • 활성화 — 올바른 파일은 필요 조건이지 충분 조건이 아닙니다. 제어 역할을 하는 것(가드, 거부 규칙, 훅 매처, 정규식, 권한 패턴, 카나리 assertion, 무시 규칙)에 대해, 그것이 잡기 위해 존재하는 긍정적인 경우를 심고 그것이 발동하는지 지켜본 후, 부정적인 경우를 심고 조용히 넘어가는지 지켜보십시오. 발동하는 것이 관찰된 적 없는 제어는 **검증되지 않음(UNVERIFIED)**입니다. 보호 역할을 하지만 발동할 수 없었던 제어들: 실행에서 발견된 모든 사례 — 중간 명령어 토큰을 차단할 수 없는 접두사 매처였던 거부 규칙; \R이 X:Repo로 컴파일되어 실제 경로와 일치할 수 없었던 유출 정규식; 대문자 철자를 통과시킨 대소문자 구분 이름 필터; 영원히 참이었던 assertion /findings/.test(src).
  • 파일당 판정: 반영됨(LANDED) / 잘못 반영됨(MISLANDED) / 검증 불가(UNVERIFIABLE) (이유를 명시). 실행 중인 복사본을 확인할 수 없는 파일은 LANDED가 아닌 UNVERIFIABLE입니다. 뒤에 남겨진 죽은 복사본 자체는 발견 사항이 아닙니다. 어떤 복사본이 활성화되어 있고 편집 내용이 그 안에 있는지 말하십시오.

2. 주장(CLAIMS) — 서면 기록이 디스크와 일치하는가?

산출물에서 확인 가능한 모든 주장을 추출한 다음, 각각을 독립적으로 재도출하십시오. 가능한 경우 원래 생성한 명령과 다른 명령을 사용하십시오. 우선 순위는 수확량이 높은 순서대로입니다:

  1. 보편성(Universals) — "7개 모두", "모든 복사본", "바이트 단위로 동일", "남은 것 없음", "발견 사항 0개", "17개 저장소 전체에 걸쳐 유출 없음". 하나라도 놓치면 전체 진술이 거짓이 되며, 이것이 08-05 오류를 발생시킨 유형입니다. 전체 집합을 열거하고 각 구성원을 확인하십시오. 절대 점검을 보편성의 증거로 받아들이지 마십시오. 점검만 할 수 있었던 보편성은 **검증되지 않음(UNVERIFIED)**입니다.
  2. 개수(Counts) — "17개 규칙", "29개 스킬", "21/21". 문장이 아닌 진실의 원천에서 세십시오. 시제를 주의하십시오: 계산되는 항목 내부에 기록된 항목 수는 적용되는 순간 1이 차이납니다; 더티 파일 내부에서 만들어진 "남은 유일한 더티 파일" 주장은 스스로를 거짓으로 만듭니다; 아직 존재하지 않는 항목을 인용하는 것은 작성될 때까지 아무것도 가리키지 않습니다.
  3. 상태(States) — "통과", "깨끗함", "재생성됨", "푸시됨". 직접 실행하거나, 그것을 증명하는 산출물을 읽으십시오. 인용된 출력은 프로그램에 대한 주장입니다: 산출물이 도구 출력의 한 줄을 증거로 인용하는 경우, 해당 도구에서 그 문자 그대로의 문자열을 grep 하십시오. 실패 분기에서만 출력되는 줄은 통과를 증명할 수 없으며, 프로그램이 절대 출력하지 않는 줄은 조작된 인용입니다.
  4. 숫자(Numbers) — 추적하는 출력보다 유효 숫자가 더 많은 값은 조작된 것입니다 (2dp 표에서 4dp로 게시된 13개 공유 개수: 12개가 틀림). 라이브 코퍼스(트랜스크립트, 로그, 성장하는 기록)의 통계는 코퍼스 상태(파일 수 + 타임스탬프)가 고정되지 않으면 재현할 수 없습니다. **명시된 대로 검증 불가(UNVERIFIED-AS-STATED)**로 보고하고, 재현되는 것이 무엇인지 밝히십시오. 한 문장 내의 산술을 확인하십시오 ("27 더하기 3 … 오늘 29"). 비교의 경우: 모든 팔에 동일한 샘플 세트, 추정기 이름 명시, n 명시 — 배치를 공유하지 않는 2x2는 비교가 아닙니다. 없는 필드는 false가 아닙니다. float32를 통해 왕복하는 float에 대한 ==는 결코 일치하지 않았으며, 커밋된 JSON은 실제 0.605에 대해 0.0을 보유했습니다.
  5. 내부 모순(Internal contradiction) — 다섯 줄 뒤에 있는 자체 단락의 주의 사항에 의해 거짓으로 판명된 문장; 날짜가 찍힌 취소선 없이 주장과 반박이 모두 존재함; 동일한 수치가 세 번 인용되었고 모두 틀림.

확인할 수 없는 주장은 **검증되지 않음(UNVERIFIED)**으로 보고하며, 절대 참이라고 보고하지 마십시오. 명시된 이유와 다르지만 참인 주장은 발견 사항입니다.

3. 부수적 영향(COLLATERAL) — 무엇이 이동해야 했는데 이동하지 않았는가?

diff는 무엇이 변경되었는지 보여줍니다. 이 단계는 변경 사항이 의무화했지만 완료되지 않은 것이 무엇인지 묻습니다. diff의 역을 실행하십시오: 변경된 각 값이나 개념에 대해, 트리에서 여전히 이전 값을 주장하는 다른 곳을 grep 하십시오.

  • 형제 복사본 — 동일한 파일을 보유한 다른 모든 트리/브랜치/패키지. 잘못 반영된 수정 사항 자체가 두 복사본 중 하나에 잘못 반영되었습니다; 비공개 파일을 공개 쌍둥이에 전체 복사하는 것은 이전 커밋이 의도적으로 제거한 것을 다시 도입한 것입니다. 공개 복사본을 비공개 소스가 아닌 자체 git show HEAD:와 비교하십시오.
  • 수정 전파 — 작업이 주장을 수정하는 경우, 이전 주장의 다른 모든 복사본을 찾으십시오: HANDOFF, PRD, 메모리 빈, README, 코드 주석, 공개 쌍둥이, 스킬 자체 설명. "기록에서 수정되었지만, HANDOFF와 빈은 이전 숫자를 계속 명시함" 및 "이 주장의 세 번째 복사본은 여전히 취소되지 않음"은 모든 실행에서 가장 반복되는 발견 사항입니다.
  • 변경된 값을 인용하는 문서 — README, 스킬 설명, HANDOFF, PRD, 주석, MUST print N/N 핀. 코드에서 변경되었지만 문서에서 변경되지 않은 개수는 발견 사항입니다.
  • 공개 유출 — 반드시 있어서는 안 되는 곳에 반영됨. 수정된 트리 중 공개된 것이 있다면: 해당 트리의 diff(및 변경된 파일을 HEAD와 비교)에서 개인 식별자(이름, 이메일, 절대 경로, 비공개 프로젝트 이름)를 대소문자 구분 없이 스캔하십시오. 이 변경 사항이 문자열을 도입했는지 상속했는지 말하십시오. 둘은 다른 수정이 필요하며, 작성자는 이전에 첫 번째를 두 번째로 잘못 부른 적이 있습니다.
  • 생성된 쌍둥이 — 기록의 렌더링된 HTML, TOC 행, 메모리 빈, 앵커: 재생성되었습니까? 한 제목 일찍 위치하지만 해결되는 앵커는 "깨짐"이 아니므로, broken: 0이 그것을 증명하지 않습니다.
  • 새로운 산출물 유형 — 작업이 이전에 존재하지 않았던 파일 종류(캐시 디렉토리, 빌드 출력, 로그)를 생성했습니까? 무시 규칙이 있으며, 올바른 저장소에 있습니까?
  • 부산물 — 생성되고 남겨진 파일: 추적되지 않은 파일, 임시 디렉토리, __pycache__, .tmp, 백업. 전체 경로와 함께 나열하십시오. 아무것도 삭제하지 마십시오.
  • 문서에 명시된 의무 — 프로젝트 자체 규칙이 이러한 종류의 변경에 특정 작업(기록 항목, 재생성된 쌍둥이, 동기화된 스냅샷, 테스트 실행, 핀 업데이트)을 요구한다면, 그것이 발생했는지 확인하십시오.

프로브(Probe) — 기계적 절반, 에이전트가 판단하기 전에 실행

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 — 저장소별 staged / modified / untracked; --file은 저장소 외부의 파일을 지정합니다; --since N은 NON-저장소 루트 아래에서 지난 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.
  • 부수적 영향 목록: 이동해야 했지만 이동하지 않은 것, 각각 경로 포함.
  • 확인됨: 부담을 지탱하는 부정과 정확히 재도출된 숫자 (misland 없음, 누출 없음, 25/25 재현됨) — 결함만 보고하는 스캔은 견고한 것이 무엇인지 가르쳐주지 않으며, 작성자의 기록에 필요합니다.
  • 인계 사항: /code-review, /audit, 또는 coding-conventions에 속하는 모든 것, 여기서 반쯤 처리하지 않고 이름을 지정하고 전달합니다.

보고서 이후

  • 행동에 옮기기 전에 모든 발견 사항을 직접 재검증하십시오. 검증자의 주장도 주장입니다: 한 실행에서 재도출된 정수가 코퍼스가 그 아래에서 성장했기 때문에 틀렸습니다; 불변 조건은 유지되었습니다. 재현되는 것을 수용하십시오.
  • 수정 사항은 동일한 세 가지 질문의 대상입니다. FIX FIRST 발견 사항에 대한 수정 사항은 모든 복사본과 이전 값을 인용하는 모든 문서로 전달되어야 합니다. 두 복사본 중 하나에 잘못 반영된 수정을 수정한 실행은 수정 사항을 두 복사본 중 하나에만 전달했습니다.
  • 기록 항목은 마지막 검증 실행 이후, 그 전이 아닌, 재도출된 값으로 작성하십시오: 먼저 작성된 항목은 예상한 상태를 기록하며, 추가 전용 기록은 이를 영구적으로 만듭니다.

규칙

  • 발견 사항만. 변경하지 마십시오.
  • 파일을 수정하거나 생성하지 마십시오.
  • 명령을 실행하지 마십시오. (프로브 제외)
  • 파일 내용을 읽지 마십시오. (프로브가 이미 sha256을 계산했습니다)
  • 하나의 발견 사항에 대해 한 줄만.
  • 추측하지 마십시오. 모르면 UNVERIFIABLE.

출처

이 스킬은 다음에서 비롯됩니다:

  • core.hooksPath로 인해 죽은 파일에 적용된 보안 패치 (08-05).
  • 수치가 잘못된 상태 모니터링 보고서.
  • 동기화되지 않은 공개/비공개 트리.
  • 전파되지 않은 수정 사항.
  • 일치하지 않는 복사본.

이러한 각각은 /landing-check가 잡도록 설계된 실패 모드입니다.


번역: 이 파일은 원문 claude-skill-suite 저장소의 SKILL.md를 한국어로 번역한 것입니다.

관련 스킬