surface — команда для Claude Code: что делает и как установить
Команда surface показывает ранжированную поверхность атаки цели из манифеста разведки и истории охоты за уязвимостями.
MIT ★ 16 193 обновлён 2026-10-29
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsoulsЧто делает surface
Команда читает манифест recon/<target>/manifest.json, который создаёт cbh recon, и память о проверенных endpoint'ах. Затем накладывает сигнал из engine/skill_map.py (связь поверхности, класса бага и скилла) и выдаёт три списка: P1 (начать отсюда), P2 (после P1) и Kill List (пропустить). Детерминированное ранжирование берётся из cbh surface <target>.
Выводит endpoint'ы с технологиями, датой обнаружения и предложенными векторами проверки (IDOR, обход авторизации, загрузка файлов). Без данных разведки команда предложит сначала запустить /recon target.com.
Какие задачи решает
- вывести приоритизированный список endpoint'ов для проверки на уязвимости
- увидеть связь поверхности атаки с классами багов и скиллами
- отфильтровать endpoint'ы, которые не стоит проверять
Примеры запросов агенту
- Покажи поверхность атаки для
example.com - Запусти
/claude-bughunter:surface api.target.io - Выведи ранжированный список endpoint'ов
shop.example.org
Как установить surface
1Через маркетплейс плагинов
/plugin marketplace add elementalsouls/Claude-BugHunter/plugin install claude-bughunter@elementalsouls2Вручную: положить файлы
.claude/commands/surface.mdВызов — /surface. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/surface.mdВызов — /prompts:surface. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/surface.prompt.mdВручную: положить файлы
.gemini/commands/surface.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о surface
Как установить surface в Claude Code?
Выполни /plugin marketplace add elementalsouls/Claude-BugHunter, затем /plugin install claude-bughunter@elementalsouls. Команда будет в .claude/commands/surface.md.
Что делает команда surface?
Читает манифест разведки цели и память о проверках, ранжирует endpoint'ы по приоритету и выдаёт три списка: P1 (начать), P2 (после P1) и Kill List (пропустить).
Что нужно для работы surface?
Сначала запусти /recon target.com, чтобы создать манифест recon/<target>/manifest.json. Без него команда предложит выполнить разведку.
Исходный текст
surface.md · MIT
---
name: surface
description: Show ranked attack surface for a target from its recon manifest + hunt memory. Deterministic backing is `cbh surface <target>` (reads recon/<target>/manifest.json); LLM layer adds ledger signal. Usage: /surface target.com
---
# /surface
View the prioritized attack surface for a target.
## What This Does
1. Reads the recon manifest at `recon/<target>/manifest.json` (produced by `cbh recon`)
— the deterministic ranking comes from `cbh surface <target>`
2. Reads hunt memory for patterns and previously tested endpoints
3. Layers `engine/skill_map.py` (surface → bug-class → skill) + ledger signal on
top of the manifest's `ranked_surface` (P1/P2/Kill)
4. Outputs P1 (start here), P2 (after P1), and Kill List (skip)
> The manifest is the recon→hunt contract — see [`docs/recon-manifest.md`](../docs/recon-manifest.md).
> Run `cbh surface <target>` for the raw deterministic ranking.
## Usage
```
/surface target.com
```
## Prerequisites
Run `/recon target.com` first. If no recon data exists, you'll be prompted to run recon.
## Output
```
ATTACK SURFACE: target.com
═══════════════════════════════════════
Priority 1 (start here):
1. api.target.com/v2/users/{id} — IDOR candidate
Tech: Express + PostgreSQL | First seen 12 days ago
Suggested: numeric ID swap on GET/PUT/DELETE
2. api.target.com/graphql — introspection enabled, 47 mutations
Suggested: field-level auth check on sensitive mutations
Priority 2 (after P1):
1. cdn.target.com:8443/upload — file upload endpoint
Suggested: extension bypass, magic bytes
Kill List (skip):
- static.target.com — CDN only
- docs.target.com — third-party hosted
Memory:
- Pattern from alpha.com (same tech): auth bypass via method override ($800)
- 3 endpoints tested in previous session, 5 remain
```
© Sachin Sharma · MIT · elementalsouls/Claude-BugHunter