security-audit: 코딩 에이전트에게 6단계 보안 감사를 시키기

누구에게 맞나

현재 코딩 에이전트가 보안 감사원처럼 일하고 여섯 단계——정찰, 사냥, 검증, 보고, 구조화 출력, 독립 확인——를 끝까지 진행해 실제 영향이 있고 이용 가능한 취약점을 찾게 하려면 security-audit을 사용한다. 여러 병렬 서브에이전트를 편성하며, 이름 없는 스캔 제품을 손으로 클릭하게 하지 않는다.

전제: 코딩 에이전트가 쓰는 모델이 도구 호출과 병렬 서브에이전트를 지원해야 한다. 5단계 schema 검증에는 Node.js도 필요하며 validate-findings.cjs에 대응한다. 자료는 에이전트 제품 목록이 아니라 능력 요구를 나열하므로 특정 소프트웨어 전용으로 이해해서는 안 된다. 공식 설명 페이지는

https://github.com/cloudflare/security-audit-skill

3분 안에 첫 시도 끝내기

공식 설치 명령은 발췌에 있다:

npx skills add https://github.com/cloudflare/security-audit-skill  --skill security-audit

이 명령은 skill을 쓰므로 부작용이 있다. 현재 환경이 감사에 쓸 코딩 에이전트인지 확인한 뒤 실행한다. 설치 후 먼저 이 머신에 Node.js가 있는지 확인한다. 5단계에서 validate-findings.cjs를 돌리기 때문이다.

알 수 없는 저장소에 바로 「pen-test the code」라고 말하지 말 것. security audit, find vulnerabilities, pen-test the code 같은 트리거 문구에 맞는 요청은 자동으로 활성화된다. 출력 디렉터리를 지정하지 않으면 물어보고 기본으로 ~/security-audit-skill/<repo-name>/run-<N>에 쓴다. 홈 디렉터리 아래에 파일이 생긴다.

저위험 첫 시도: 설치 성공 후 먼저 비어 있고 내가 소유한 출력 디렉터리를 지정하고 「지금 감사하면 출력은 어디에 쓰이나」만 묻는다. 코드를 바꾸거나 밖으로 패킷을 보내기 시작할 권한은 주지 말 것. 성공 신호: skill이 설치되었고, 에이전트가 기본 출력 경로 규칙을 되말할 수 있으며, 디렉터리를 확인하기 전에 6단계를 시작하지 않았다. 진짜 전체 감사를 돌릴 때는 대상 저장소와 출력 경로를 먼저 확인한 뒤 트리거 문구를 사용한다.

사용 사례

사례 1: 내가 소유한 코드 저장소에서 감사를 시작한다. 공식 설치를 마치고 Node.js를 쓸 수 있는지 확인한 뒤 명확한 출력 디렉터리를 주고 자료의 트리거 문구 중 하나를 사용한다. 완료 기준은 에이전트가 여섯 단계에 들어가 지정 디렉터리에 이번 run 출력을 남기는 것이다. 기본 경로로 남기고 싶지 않은 옛 결과를 덮어쓰지 말 것. 발췌는 각 단계의 내부 명령을 쓰지 않으므로 정찰이나 사냥의 구체 스크립트를 지어내지 말 것.

사례 2: 이용할 수 있는 발견만 남긴다. 자료의 요구: 이용할 수 있는 문제만 보고하고, 각 발견에는 구체 공격 시나리오가 있어야 하며 「공격자는 이론상……」이 아니어야 한다. 5단계는 validate-findings.cjs로 schema 검증을 한다. 이는 출력에 대한 제약이다. 먼저 검증을 돌린 뒤 어떤 항목을 남길지 결정한다. 요약은 대항 검증을 발견자와 다른 에이전트가 해야 한다고도 말하지만 발췌는 에이전트 전환 명령을 쓰지 않는다. 이 사례의 완료 기준은 「항목이 구체 시나리오를 갖고 schema를 통과함」이며 검증 에이전트가 이미 자동으로 바뀐 것이 아니다.

사용 경계

여섯 단계는 정찰, 사냥, 검증, 보고, 구조화 출력, 독립 확인이다. 기본 출력은 ~/security-audit-skill/<repo-name>/run-<N>. Node.js가 없으면 5단계 검증을 끝내지 못한다. 도구 호출과 병렬 서브에이전트가 없으면 자료가 쓴 실행 요구에 미치지 못한다.

이용할 수 없는 이론적 문제를 보고하지 말 것. 허가되지 않은 대상에 pen-test 트리거 문구를 쓰지 말 것. 자료는 클라이언트 목록도, Node.js가 없을 때 검증을 건너뛰는 방법도 쓰지 않는다. 여기에 적힌 설치, 트리거, 출력 디렉터리, 보고 기준을 넘는 범위는 이 설명이 다루지 않는다.