Community코딩 & 개발github.com

engguh01/spotter

코딩 에이전트가 파일을 읽기 전에 관련 파일을 찾아주는 스코프-비포-리드 Agent Skill (SKILL.md)입니다. 마치 저격수의 관측수가 좌표를 알려주는 것과 같습니다.

spotter란 무엇인가요?

engguh01/spotter는 AI 코딩 에이전트(예: Claude Code, Cursor, Codex 등)가 파일을 읽기 전에 먼저 관련 파일의 위치를 찾아주는 Agent Skill입니다. 이 스킬은 '스코프 비포 리드(scope-before-read)' 원칙에 따라 동작하여, 에이전트가 불필요한 파일을 읽는 것을 방지하고 작업에 정말 필요한 파일에만 집중할 수 있도록 돕습니다. SKILL.md 문서를 기반으로 프로젝트 구조를 분석하여 작업 범위를 좁히고, 저격수의 관측수가 정확한 좌표를 제공하듯 에이전트에게 정확한 파일 경로를 제공합니다. 이를 통해 개발자는 에이전트의 검색 시간을 줄이고, 에이전트는 더 빠르고 정확한 코드 수정을 수행할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add engguh01/spotter

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

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

파일을 읽기 전에 범위를 정하는 Agent Skill (SKILL.md)입니다. 코딩 에이전트가 파일을 읽기 전에 관련 파일을 찾아줍니다. 마치 저격수의 관측수가 좌표를 알려주는 것과 같습니다.

개요

이 스킬은 AI 코딩 에이전트가 프로젝트에서 관련 파일을 먼저 찾은 후에야 실제 코드 읽기 및 수정 작업을 수행하도록 설계되었습니다. 에이전트가 불필요한 파일을 읽는 데 시간을 낭비하지 않고, 필요한 파일에만 집중할 수 있도록 합니다.

사용 방법

  1. 에이전트에게 작업을 요청할 때 spotter 스킬을 활성화합니다.
  2. 에이전트가 SKILL.md에 정의된 규칙에 따라 프로젝트를 스캔하고 관련 파일을 식별합니다.
  3. 식별된 파일 목록을 제공하면 에이전트가 해당 파일만 읽고 작업을 수행합니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 SKILL.md을 지원하는 AI 코딩 에이전트

예시

# 에이전트에게 spotter 스킬을 활성화하고 작업 요청
$ claude code --skill spotter "로그인 기능의 버그를 수정해줘"

작동 방식

  1. 에이전트가 skill.md을 로드하고 spotter 규칙을 활성화합니다.
  2. 에이전트가 현재 작업 컨텍스트를 분석하고 관련 파일 범위를 좁힙니다.
  3. 범위 내 파일만 읽고 작업을 수행합니다.

이를 통해 에이전트는 마치 저격수의 관측수가 정확한 좌표를 알려주듯, 정확한 파일에 집중하여 효율적으로 작업할 수 있습니다.

관련 스킬