AI 칼럼

보안@donghyeok99운영진

security-audit: 에이전트를 보안 감사관으로 바꾸는 Cloudflare 스킬

Cloudflare 취약점 탐색 하네스의 출발점이던 보안 감사 스킬이 MIT로 공개돼 있어요

명령 한 줄 뒤 hunter들이 코드를 훑어 후보를 찾고, 찾지 않은 verifier가 반박해 confirmed·needs_validation·rejected로 가른 다음 REPORT.md를 남겨요.
명령 한 줄 뒤 hunter들이 코드를 훑어 후보를 찾고, 찾지 않은 verifier가 반박해 confirmed·needs_validation·rejected로 가른 다음 REPORT.md를 남겨요.
누가
Cloudflare가 자기 취약점 탐색 하네스의 출발점이던 스킬을 공개했어요. 코딩 에이전트로 자기 코드를 점검하려는 개발자용이에요.
언제
저장소는 2026년 6월 18일에 열렸고 릴리스 태그 없이 main으로 배포해요. 감사 흐름과 검증기를 다시 짠 개편은 9월 10일이에요.
어디서
도구 사용과 병렬 서브 에이전트를 지원하는 코딩 에이전트 어디서나. 소스는 내 PC에서 읽고, 결과는 저장소 밖 폴더에 써요.

이게 불편했어요

코딩 에이전트에게 「보안 점검해 줘」라고 하면 그럴듯한 목록이 돌아와요. 그런데 모범 사례가 빠졌다는 지적과 실제로 뚫리는 구멍이 한 목록에 섞여 있어서, 무엇부터 고쳐야 할지 하나씩 다시 따져 봐야 했어요. 찾은 에이전트가 그 결과를 스스로 확인하니 믿기도 어려웠고요.

그래서 이렇게 풀어요

이 스킬은 찾는 쪽과 확인하는 쪽을 나눠요. 여러 hunter가 커버리지 원장의 단위를 나눠 훑어 후보를 내면, 그 후보를 찾지 않은 새 에이전트가 반박을 시도하고 살아남은 것만 confirmed가 돼요. 소스에 없는 배포 설정처럼 확인할 수 없는 사실에 막힌 건 needs_validation으로 남기고 심각도를 붙이지 않아요. 결과는 스키마로 검증한 findings.json과 REPORT.md로, 감사 대상 저장소 밖 폴더에 쌓여요.

cloudflare/security-audit-skill

이걸로 만든 사람들

Hacker Newsjesse_dot_id2026-09-17

작은 FastAPI 프로젝트에 돌려 봤더니 15만 토큰 넘게 쓰고 세션 한도에 걸려서, 몇 시간 뒤에 이어 돌리겠다고 남겼어요.

At least 150k on my relatively small FastAPI project, but hit my session limit. Continuing in a few hours.

안에서는 이렇게 돌아가요

  1. 1

    나 → 코딩 에이전트 (parent)

    security audit this codebase감사나 펜테스트를 분명히 요청하면 6단계 전체를, 보안 질문이면 필요한 부분만 써요.skills/security-audit/SKILL.md
  2. 2

    코딩 에이전트 (parent) → hunter 에이전트들

    coverage-ledger.json의 단위 배정정찰 에이전트들이 구조와 신뢰 경계를 그리면, parent가 원장을 만들고 단위마다 hunter를 붙여요.skills/security-audit/RECONNAISSANCE.md
  3. 3

    hunter 에이전트들 → 코딩 에이전트 (parent)

    구조화된 후보 결과hunter는 자기 scratch 폴더에만 쓰고 후보를 정해진 형식으로 돌려줘요. critic 웨이브가 빈 곳을 찾아요.skills/security-audit/HUNTING.md
  4. 4

    코딩 에이전트 (parent) → verifier 에이전트

    후보 하나마다 새 verifier후보를 찾지 않은 에이전트가 반박을 시도해 confirmed, needs_validation, rejected로 갈라요.skills/security-audit/VALIDATION-AND-REPORTING.md
  5. 5

    코딩 에이전트 (parent) → validate-findings.cjs

    findings.jsonreport-schema.json의 형식과 판정 규칙을 검사하고, 오류가 없을 때까지 고친 뒤에야 다음 단계로 가요.skills/security-audit/validate-findings.cjs
  6. 6

    코딩 에이전트 (parent) → REPORT.md

    REPORT.md, FINDINGS-DETAIL.md, NEEDS-VALIDATION.md새 에이전트가 최종 기록을 다시 확인한 뒤, 검증된 기록과 원장에서만 보고서를 만들어요.skills/security-audit/VALIDATION-AND-REPORTING.md

넣으면 이렇게 나와요

security audit this codebase전체 감사 모드, 결과는 ~/security-audit-skill/<repo-name>/run-<N>
do a security review, output to ~/audits/my-project같은 감사를 하고 보고서를 ~/audits/my-project에 써요
보안 질문 하나나 특정 취약점 조사guidance mode: 파일을 만들지 않고 필요한 부분만 답해요
같은 저장소에 한 번 더 실행앞선 원장과 findings를 읽고 빈 곳과 바뀐 소스를 겨냥해요

나한테 맞을까요

이럴 때 좋아요

  • 출시 전, 내 서비스 코드에 실제로 뚫리는 경계가 있는지 소스 근거와 함께 보고 싶을 때
  • 결과를 사람이 읽는 보고서와 기계가 읽는 JSON 둘 다로 받고 싶을 때
  • 한 번에 끝내기보다 여러 번 돌려 커버리지를 쌓아 갈 생각일 때
  • 웹 API뿐 아니라 LLM 앱, 데스크톱 앱, 클라우드 설정, 공급망까지 한 틀로 점검하고 싶을 때

이건 안 돼요

  • README 기준, 한 번 실행으로는 여러 번 돌려 찾은 취약점의 대략 절반만 찾았어요.
  • 대상 코드를 빌드하거나 실행해 확인하려면 외부 네트워크를 막은 OS 샌드박스가 필요하고, 없으면 실행하지 않고 needs_validation으로 남겨요.
  • 에이전트를 여러 개 띄워서 토큰을 많이 써요. Hacker News 후기에는 15만에서 100만 토큰을 썼다는 말이 있어요.
  • Windows에서는 Node에 O_NOFOLLOW가 없어 validate-findings.cjs가 입력을 읽지 못해요 (이슈 #117).

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기