Community라이팅 & 에디팅github.com

agentscan

에이전트 설정 파일의 끊어진 hook 스크립트, 디스크와 일치하지 않는 MCP/스킬 등을 찾아내는 읽기 전용 린터입니다. 네트워크 연결이 필요하지 않습니다.

agentscan란 무엇인가요?

`SimaAlexandru99/agentscan`은 AI 에이전트(Claude Code, Cursor, Codex 등)의 설정 파일을 정적으로 분석하여 문제점을 찾아내는 읽기 전용 린터(linter)입니다. hook에 선언된 스크립트 파일이 실제로 존재하는지, `.mcp.json`이나 `skills-lock.json`에 정의된 MCP 서버 및 스킬이 실제 디스크의 파일 구조와 일치하는지 검증합니다. 로컬에서 실행되므로 네트워크 호출이 없어 빠르고 안전하며, 특히 에이전트 작업 중 가드(guard)가 활성화되었지만 스크립트가 실제로 존재하는지 확인되지 않은 상황이나, 설정 파일을 변경하는 PR 리뷰 시 유용합니다. 발견된 문제는 사실(fact)로 보고되며, `--output prompt` 옵션을 통해 수정 에이전트에게 전달할 수 있는 형식으로 출력됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add SimaAlexandru99/agentscan

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

agentscan은(는) 무엇을 하나요?

에이전트 설정을 위한 읽기 전용 린터입니다. 발견 사항은 사실입니다.

사용 시점

  • Hook, 스킬, MCP, 또는 AGENTS.md 작업 중
  • 누군가 가드가 켜져 있다고 말했는데 스크립트를 확인하지 않은 경우
  • PR이 .claude/, .commandcode/, .agents/, .mcp.json 또는 skills-lock.json을 건드리는 경우

수행 방법

리포지토리 루트에서:

npx @chimix/agentscan@latest --output prompt

--output prompt는 수정하는 에이전트에게 전달하기 위한 핸드오프 형식입니다. claude.hook.missing-script (오류)를 건너뛰지 마십시오.

준비된 프로젝트가 없는 경우:

npx @chimix/agentscan@latest demo

demo는 임시 픽스처를 만들고, 보고서를 출력한 다음, 픽스처를 삭제합니다.

하지 말아야 할 것

  • 검사한 트리를 기록하지 않음
  • 모델을 사용하여 hook이 유효한지 추측하지 않음
  • 스킬의 프론트매터 name과 디렉토리를 비교하거나 모델 ID를 검증하지 않음

관련 스킬