Agent-Threat-Rule/agent-threat-rules

어떤 프로젝트인가요?

핵심 기능

• 01규칙은 버전 관리 스키마를 갖춘 YAML 문서이며, 공개 ATR-YYYY-NNNNN 식별자 체계를 사용합니다.
• 02Python 패키지(pyatr)를 함께 제공하는 TypeScript 엔진 및 CLI입니다.
• 03규칙을 regex, Splunk SPL, Elasticsearch 쿼리 형식으로 내보냅니다.
• 04GitHub Action이 코드 스캐닝용 SARIF 결과를 출력합니다.
• 05Claude Code와 Cursor 같은 IDE 클라이언트와 실시간 연동하는 MCP 서버입니다.
• 06각 규칙은 OWASP Agentic Top 10, OWASP LLM Top 10 및 MITRE ATLAS 참조 항목과 매핑됩니다.

활용 사례

• 병합 전에 CI에서 SKILL.md 파일과 MCP 서버 구성을 스캔합니다.
• 엔진 API를 통해 에이전트 프레임워크나 프록시에 런타임 프롬프트 인젝션 검사를 추가합니다.
• 기존 Splunk 또는 Elasticsearch 같은 SIEM에 탐지 규칙을 내보냅니다.
• 공유 및 테스트 가능한 에이전트 공격 패턴 모음으로 LLM 애플리케이션을 레드팀 테스트합니다.

빠른 시작

1. 1

   npm 패키지를 설치합니다

   npm install agent-threat-rules
2. 2

   CLI로 SKILL.md 파일을 스캔합니다

   atr scan skill.md

사용 전 알아둘 점

• !Lane의 오탐률은 철회되었으며 아직 재측정되지 않아 현재 정밀도 수치를 확인할 수 없습니다.
• !현재 거버넌스는 단일 메인테이너 체제이며, 향후 Technical Steering Committee로 전환할 계획입니다.

토픽

자주 묻는 질문

agent-threat-rules은(는) 무엇인가요?

AI 에이전트 보안 위협을 위한 개방형 탐지 규칙 형식으로, 프롬프트 인젝션·도구 포이즈닝·MCP 공격을 실행하고 테스트할 수 있는 YAML 규칙을 제공합니다. ATR(Agent Threat Rules)은 AI 에이전트를 겨냥한 공격을 탐지하기 위한 벤더 중립적 규칙 형식으로, SIEM 로그용 Sigma와 악성코드용 YARA를 모델로 삼았습니다. 각 규칙은 공격 패턴, 검사 대상 입력 필드(LLM 입력 및 출력, 도구 호출 인수, SKILL.md 콘텐츠 또는 에이전트 구성), 테스트 케이스, OWASP·MITRE ATLAS 및 기타 프레임워크와의 매핑을 선언하는 버전 관리 스키마를 갖춘 YAML 문서입니다.

agent-threat-rules은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agent-threat-rules은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agent-threat-rules은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. agent-threat-rules의 마지막 커밋은 2026년 11월 6일입니다.

agent-threat-rules은(는) 어디에 사용할 수 있나요?

병합 전에 CI에서 SKILL.md 파일과 MCP 서버 구성을 스캔합니다. 엔진 API를 통해 에이전트 프레임워크나 프록시에 런타임 프롬프트 인젝션 검사를 추가합니다. 기존 Splunk 또는 Elasticsearch 같은 SIEM에 탐지 규칙을 내보냅니다. 공유 및 테스트 가능한 에이전트 공격 패턴 모음으로 LLM 애플리케이션을 레드팀 테스트합니다.

agent-threat-rules는 어떻게 설치하나요?

npm 패키지를 설치합니다: npm install agent-threat-rules CLI로 SKILL.md 파일을 스캔합니다: atr scan skill.md

agent-threat-rules은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Agent-Threat-Rule/agent-threat-rules