# codebase-comprehension-algorithms

Скилл codebase-comprehension-algorithms раскладывает незнакомый репозиторий на функциональные домены: какие файлы стоят за фичей и где проходит архитектурный каркас.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 148 установок · ★ 227 у репозитория
- Автор: pproenca
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/codebase-comprehension-algorithms/SKILL.md
- Обновлён: 2026-08-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/codebase-comprehension-algorithms

## Что делает

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

Внутри девять категорий: построение графа, кластеризация (Leiden, Infomap, SBM, MCL, Walktrap, спектральный метод, HDBSCAN), метрики качества вроде MoJoFM и ARI/NMI, разбор идентификаторов, восстановление архитектуры (Bunch+MQ, ACDC, Limbo, Reflexion), тематическое моделирование, поиск совместных изменений, теоретико-информационные меры и центральность. Каждое правило лежит отдельным файлом со ссылками на статьи ICSE, FSE, TSE, PNAS и книги.

Обученные модели вроде GNN и CodeBERT в набор не входят, рецепты рефакторинга тоже. Практический вывод простой: если перед кластеризацией не отбросить общие утилиты вроде логгеров и базовых классов, качество разбиения просядет — в скилле это правило стоит первым среди графовых.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill codebase-comprehension-algorithms -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill codebase-comprehension-algorithms -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill codebase-comprehension-algorithms -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills skills/.experimental/codebase-comprehension-algorithms
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill codebase-comprehension-algorithms -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/codebase-comprehension-algorithms
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill codebase-comprehension-algorithms -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/codebase-comprehension-algorithms/SKILL.md

## Когда брать
- Понять, из каких подсистем состоит чужой репозиторий
- Найти файлы, реализующие оплату, авторизацию или поиск
- Проверить, не проломил ли рефакторинг границы модулей
- Сверить архитектуру из README с тем, что реально в коде
- Выбрать алгоритм кластеризации под конкретный вопрос

## Примеры запросов агенту
- Разбери этот репозиторий по бизнес-доменам и покажи, какие файлы к какому относятся.
- Где здесь реализована авторизация? Нужен список файлов и связи между ними.
- Проверь, не нарушил ли этот рефакторинг границы модулей, и покажи неожиданные связи.

## Похожие
- [codebase-analyzer](https://affpapa.org/nevibecode/skills/codebase-analyzer.md) — скилл · 868 установок
- [codebase-analysis](https://affpapa.org/nevibecode/skills/codebase-analysis.md) — скилл · 587 установок
- [graph-algorithms](https://affpapa.org/nevibecode/skills/graph-algorithms.md) — скилл · ★ 3951 у репозитория
- [codebase-memory-mcp](https://affpapa.org/nevibecode/skills/codebase-memory-mcp.md) — скилл · 259 установок
- [codebase-onboarding](https://affpapa.org/nevibecode/skills/codebase-onboarding.md) — скилл · 698 установок
- [analyze-codebase](https://affpapa.org/nevibecode/plugins/analyze-codebase.md) — плагин · ★ 1013 у репозитория

Из того же набора: [pproenca/dot-skills](https://affpapa.org/nevibecode/by/pproenca/dot-skills.md) — 139 карточек

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