scope — слэш-команда для Claude Code: проверка области
Команда scope проверяет host или URL до активного тестирования и блокирует активы вне заданных правил. Подходит для контроля области работ в bug bounty.
MIT ★ 16 193 обновлён 2026-10-29
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsoulsЧто делает scope
scope проверяет host или URL до любого активного тестирования. Команда загружает правила из scope.md или принимает их напрямую, затем печатает IN-SCOPE либо OUT-OF-SCOPE <reason>. Если хотя бы один актив не проходит проверку, процесс завершается с ненулевым кодом.
Проверка выполняется через engine/scope.py, а не по решению модели. Поддерживаются apex-домены с субдоменами, маски *.acme.com, точные host, CIDR вроде 10.0.0.0/8 и регулярные выражения с префиксом re:. Правило запрета имеет приоритет. Пустой список разрешённых активов блокирует всё, поэтому scope.md нужно заполнить до запуска.
Без заполненного scope.md команда использует безопасный режим default-deny, и активы будут отклонены.
Какие задачи решает
- проверить host до HTTP-запроса
- сопоставить актив с правилами
scope.md - остановить тестирование вне области
- проверить IP по CIDR и host по regex
Примеры запросов агенту
- Проверь, входит ли
api.acme.comв область:/scope api.acme.com. - Перед тестированием проверь
api.acme.com,staging.acme.ioиadmin.acme.comкомандой/scope api.acme.com staging.acme.io admin.acme.com. - Проверь активы по правилам из
scope.mdи остановись при результатеOUT-OF-SCOPE.
Как установить scope
1Через маркетплейс плагинов
/plugin marketplace add elementalsouls/Claude-BugHunter/plugin install claude-bughunter@elementalsouls2Вручную: положить файлы
.claude/commands/scope.mdВызов — /scope. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/scope.mdВызов — /prompts:scope. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/scope.prompt.mdВручную: положить файлы
.gemini/commands/scope.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о scope
Как установить scope в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add elementalsouls/Claude-BugHunter, затем установите плагин через /plugin install claude-bughunter@elementalsouls. Команда находится в .claude/commands/scope.md.
Что делает scope?
Команда детерминированно проверяет host или URL по правилам области и сообщает, разрешён ли актив для тестирования. При первом активе вне области она возвращает ненулевой код.
Что произойдёт, если актив подходит под разрешающее и запрещающее правило?
Сработает запрет: актив получит статус OUT-OF-SCOPE. Пустой список разрешённых активов также отклоняет все активы.
Исходный текст
scope.md · MIT
--- name: scope description: Mandatory pre-flight scope check — verify an asset is in scope BEFORE any HTTP touch. Deterministic (deny-wins, default-deny) via engine/scope.py against the engagement's scope.md. Blocks out-of-scope testing. Usage: /scope <asset> [<asset> ...] --- # /scope The mandatory pre-flight gate. Verify a host or URL is in scope **before** any active testing. Scope is enforced in **code** (`engine/scope.py`), not by LLM judgment — deny wins, default deny. ## What This Does 1. Loads in-scope / out-of-scope patterns from the engagement's `scope.md` (the `hunt` scaffold creates it) or from inline patterns. 2. Checks each asset deterministically with `engine/scope.py`: - apex `acme.com` → the apex **and** any subdomain - `*.acme.com` → any subdomain (NOT the bare apex) - `api.acme.com` → that exact host - `10.0.0.0/8` → any IP in the CIDR - `re:^lab[0-9]+\.acme\.io$` → explicit regex (prefix `re:`) 3. Prints `IN-SCOPE` / `OUT-OF-SCOPE <reason>` and exits non-zero if any asset is out of scope — so it can gate automation. ## Usage ``` /scope api.acme.com /scope api.acme.com staging.acme.io admin.acme.com ``` Under the hood, run the deterministic checker directly: ```bash # Against the engagement scope.md (preferred — fill scope.md from the program page first) python3 engine/scope.py api.acme.com --md ~/Targets/acme/scope.md # Or with inline patterns (repeat --in-scope / --out-of-scope per pattern) python3 engine/scope.py api.acme.com evil.com \ --in-scope acme.com --in-scope '*.acme.io' --out-of-scope admin.acme.com ``` ## Rules - **Run this before any HTTP touch.** An `OUT-OF-SCOPE` result is a hard stop — do not probe the asset. - If `scope.md` is still the empty template (`(paste ... here)` placeholders), fill it from the program page first; an empty in-scope list = default-deny = everything rejected, which is the safe default. - Deny wins: if an asset matches both an in-scope and an out-of-scope rule, it is out of scope.
© Sachin Sharma · MIT · elementalsouls/Claude-BugHunter