# reverse-engineering-specs

Скилл reverse-engineering-specs разбирает код без документации и пишет поведенческие спецификации: что система делает снаружи, без имён функций и библиотек. Пригодится перед рефакторингом легаси.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 116 установок · ★ 3 у репозитория
- Автор: Pixel-Process-UG
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Pixel-Process-UG/superkit-agents/tree/HEAD/templates/skills/reverse-engineering-specs/SKILL.md
- Обновлён: 2026-03-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/reverse-engineering-specs

## Что делает

Скилл берётся за проект, где код есть, а спецификаций к нему нет. Он проходит по коду и собирает описание поведения: что система делает снаружи, без имён функций и упоминаний библиотек. Работа разбита на четыре фазы, после каждой остановка с показом того, что нашлось.

Сначала исследование. Субагенты запускаются параллельно через инструмент `Agent` с `subagent_type="Explore"`, на большой кодовой базе их до 500. Смотрят точки входа, ветки и циклы, потоки данных, изменения состояния, обработку ошибок, побочные эффекты и конфигурацию. Скилл жёсткий: пропустить ветку и дописать спеку по памяти не выйдет.

Потом анализ превращается в файлы `specs/01-...md` по возможностям плюс `KNOWN_ISSUES.md` для багов, с текущим и ожидаемым поведением и важностью. Баг остаётся «текущим поведением», пока его не пометили к исправлению. В конце 12 проверок полноты: точки входа, потоки, состояние, граничные случаи, отсутствие реализации в тексте.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Pixel-Process-UG/superkit-agents --skill reverse-engineering-specs -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/reverse-engineering-specs/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/reverse-engineering-specs/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Pixel-Process-UG/superkit-agents --skill reverse-engineering-specs -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/reverse-engineering-specs/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Pixel-Process-UG/superkit-agents --skill reverse-engineering-specs -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/reverse-engineering-specs/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Pixel-Process-UG/superkit-agents templates/skills/reverse-engineering-specs
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/reverse-engineering-specs/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Pixel-Process-UG/superkit-agents --skill reverse-engineering-specs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Pixel-Process-UG/superkit-agents --path templates/skills/reverse-engineering-specs
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/reverse-engineering-specs/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Pixel-Process-UG/superkit-agents --skill reverse-engineering-specs -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Pixel-Process-UG/superkit-agents/tree/HEAD/templates/skills/reverse-engineering-specs/SKILL.md

## Когда брать
- восстановить спецификацию по легаси-коду без документации
- разложить монолит на файлы `specs/` по возможностям
- вытащить скрытые баги в отдельный `KNOWN_ISSUES.md`
- подготовить почву для рефакторинга, чтобы поведение не поехало
- передать проект новому разработчику с описанием того, как он работает

## Примеры запросов агенту
- Разбери сервис в `services/billing` и собери поведенческие спеки в `specs/`, без имён функций и библиотек.
- Прогони скилл по этому репозиторию: сначала покажи точки входа и потоки данных, спеки пиши после моего подтверждения.
- Найди в коде баги и оформи их в `KNOWN_ISSUES.md` с важностью, а готовые спеки не трогай.

## Похожие
- [product-specs-writer](https://affpapa.org/nevibecode/skills/product-specs-writer.md) — скилл · 222 установки
- [reverse-engineering](https://affpapa.org/nevibecode/skills/rehan-remade-reverse-engineering.md) — скилл · 2200 установок
- [reverse-engineering-tools](https://affpapa.org/nevibecode/skills/reverse-engineering-tools.md) — скилл · 575 установок
- [ida-mcp-headless-reverse-engineering](https://affpapa.org/nevibecode/skills/ida-mcp-headless-reverse-engineering.md) — скилл · 134 установки
- [protocol-reverse-engineering](https://affpapa.org/nevibecode/skills/protocol-reverse-engineering.md) — скилл · 12701 установка
- [learn-reverse-engineering](https://affpapa.org/nevibecode/skills/learn-reverse-engineering.md) — скилл · 1400 установок

Из того же набора: [pixel-process-ug/superkit-agents](https://affpapa.org/nevibecode/by/pixel-process-ug/superkit-agents.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
