Scope는 AI 에이전트가 정찰 단계에서 합의한 경계를 넘는 작업을 감지하고 사용자의 결정을 기다리며 일시 중지합니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install scope
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 scope 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
범위란 무엇인가요?
Scope는 AI 코딩 에이전트를 위한 범위 이탈 방지 도구입니다. 대기 중인 파일 변경, shell 명령, 종속성 추가 또는 리팩터링을 원래 작업 및 정찰 단계에서 기록한 경계와 비교합니다. 실제 범위 확장을 감지하면 실행 전에 멈추고 어떤 경계를 넘게 되는지 구체적으로 보여 주는 보고서를 작성합니다.
Openclaw Skills 도구인 Scope는 정상적인 범위 내 작업을 방해하지 않으면서 작은 개발 작업을 작게 유지하도록 돕습니다. 에이전트가 근거를 제시하고 진행하도록 허용하거나, 후속 작업으로 미루거나, 마지막 범위 내 상태로 되돌릴 수 있습니다.
범위 활용 사례
- 에이전트가 정찰 단계에서 범위 내로 지정하지 않은 파일을 편집하려는 경우 이를 포착합니다.
- shell 명령이 프로젝트 디렉터리 밖의 리소스에 영향을 줄 수 있기 전에 일시 중지합니다.
- 계획에 없던 종속성 추가나 작업과 무관한 리팩터링을 검토합니다.
- “하는 김에”와 같은 추론만을 근거로 한 작업을 중단합니다.
- 에이전트가 작업 범위를 확장해야 할 정당한 필요에 직면했을 때 사용자가 통제권을 유지하게 합니다.
- 실제 범위 이탈을 불완전한 정찰, 필수 테스트 파일, 범위 내 파일의 사소한 서식 변경과 구분합니다.
범위 작동 원리
- 에이전트는 정찰 단계에서 원래 작업과 범위 내 파일 또는 리소스를 파악합니다.
- 범위를 벗어날 가능성이 있는 작업을 수행하기 전에 Scope는 해당 작업을 작업 설명 및 정찰 단계에서 제안한 경계와 비교합니다.
- 작업이 실제 범위 이탈이라면 Scope는 실행 전에 일시 중지하고 작업, 근거, 영향을 받는 리소스 및 정확한 경계 불일치를 식별하는 구조화된 보고서를 표시합니다.
- 보고서에는 세 가지 선택지가 제공됩니다. 근거를 제시하고 진행하기, 후속 작업으로 미루기, 또는 변경 사항을 되돌리고 마지막 범위 내 상태로 돌아가기입니다.
- Scope는 사용자의 선택을 기다리며, 사용자가 응답할 때까지 추가 작업을 수행하지 않습니다.
- 결정 후에는 선택한 경로를 따릅니다. 근거를 기록하고 진행하거나, 항목을 후속 작업 목록에 추가하고 범위 내 작업을 재개하거나, 변경 사항을 되돌리고 마지막 범위 내 상태에서 다시 시작합니다.
범위 설정 가이드
제공된 SKILL.md는 Scope의 동작을 정의하지만 설치 프로그램, CLI 명령, 구성 파일 또는 필수 종속성을 지정하지 않습니다. 해당 런타임의 지침에 따라 AI 에이전트가 사용하는 skills 디렉터리 또는 레지스트리에 이 스킬을 추가하고, 에이전트가 작업 설명과 정찰 결과에 접근할 수 있도록 하세요.
# 제공된 SKILL.md에는 설치 명령이 지정되어 있지 않습니다.
# 에이전트 런타임의 문서화된 절차에 따라 스킬을 설치하거나 등록하세요.
안정적인 범위 이탈 검사를 위해 작업 요약과 정찰 중 발견한 파일 또는 리소스를 기록하세요. 추가 설정 옵션은 문서에 안내되어 있지 않습니다.
범위 데이터 스키마 및 분류 체계
Scope는 작업과 정찰 결과를 비교 기준으로 사용합니다. 이 스킬은 영구 저장 형식, 생성 파일 또는 메타데이터 분류 체계를 지정하지 않습니다.
| 정보 | 역할 |
|---|---|
| 원래 작업 요약 | 대기 중인 작업을 평가하는 데 사용하는 작업 계약을 정의합니다. |
| 정찰의 “발견한 내용” 섹션 | 이미 범위 내로 간주된 파일과 리소스를 식별합니다. |
| 대기 중인 작업 | 평가 대상인 파일, 리소스, 명령, 종속성 또는 리팩터링입니다. |
| 이탈 보고서 | 원래 작업, 제안된 작업, 범위 불일치, 선택지 및 결정 요청을 포함한 Markdown 보고서입니다. |
| 세션 로그 | 사용자가 진행을 선택할 때 근거를 기록합니다. |
| 후속 작업 목록 | 사용자가 미루기를 선택할 때 연기된 작업을 기록합니다. |
| 마지막 범위 내 상태 | 되돌린 뒤 작업을 재개할 때 사용하는 기준점입니다. |
보고서에서는 에이전트가 넘어가게 될 구체적인 경계를 명시해야 합니다. 일반적인 범위 초과 경고만으로는 충분하지 않습니다.
범위 고급 기능
- 제안된 작업이 실행되기 전에 범위 확장을 가로챕니다.
- 목록에 없는 파일 편집, 프로젝트 디렉터리 밖 리소스에 영향을 미치는 명령, 계획에 없는 종속성, 무관한 리팩터링 및 “하는 김에” 수행하는 작업 등 여러 이탈 신호를 확인합니다.
- 사용자가 작업과 위험을 평가할 수 있도록 구조화된 Markdown 이탈 보고서를 사용합니다.
- 진행, 미루기, 되돌리기의 명시적인 경로를 제공한 뒤 사용자의 확인을 기다립니다.
- 사용자가 진행을 승인하면 근거를 세션 로그에 추가합니다.
- 미루기를 유효한 기본 선택지로 취급하고, 실제 이탈을 정찰 누락, 필수 테스트 및 사소한 서식 변경과 구분합니다.
- 제공된 스킬은 훅, 다중 에이전트 조정 또는 설명된 세션 로그 및 후속 작업 처리 이외의 자동 파일 기록을 지정하지 않습니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Shell Chat
Shell Chat을 사용하면 AI 에이전트가 사람 및 다른 에이전트와 실시간으로 DM, 그룹 채팅, 사진, 파일을 주고받을 수 있습니다.
TikTok 댓글 소비자 인사이트
소비자 인사이트와 콘텐츠 연구를 지원하기 위해 공개 TikTok 검색 결과, 크리에이터 게시물 및 동영상 댓글을 구조화된 JSON으로 가져옵니다.
Blave Quant
Blave Quant는 AI 에이전트를 글로벌 시장 데이터 및 거래소 워크플로에 연결하며, 모든 거래 작업에 명시적인 확인을 요구합니다.
Chelaile 실시간 버스
Chelaile MCP를 통해 480개 도시의 실시간 버스 도착 정보, 차량 위치, 노선 및 대중교통 경로를 조회합니다.
중지
예상치 못한 장애가 발생하면 중지는 AI Agent를 멈추고 발생한 상황을 보고한 뒤, 사용자가 진행 방법을 선택할 때까지 기다립니다.
Recon
Recon은 저장소를 검사하고 위험과 미확인 사항을 드러내며, 코딩을 시작하기 전에 작업별 규칙을 사용자가 확인하도록 요구합니다.
금융 이론 마스터
금융 이론 마스터는 가정을 검증하고 증거를 평가하며 한계를 설명하여 특정 상황에 어떤 금융 이론이 적합한지 판단하도록 돕습니다.
추천*
