# lsp-architecture

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 165
- Автор: blackwell-systems
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/blackwell-systems/agent-lsp/tree/HEAD/skills/lsp-architecture/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/lsp-architecture

## Что делает

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

Внутри пять шагов. Сначала запускается LSP-сервер и определяется, какие языковые серверы доступны в рабочей папке. Дальше идёт подсчёт файлов по расширениям, поиск символов для восстановления иерархии пакетов, поиск точек входа по типовым именам вроде `main` и `Run`, а для горячих файлов вызывается `blast_radius` — он показывает, сколько вызовов придёт из нетестового кода, если файл поменять. У `blast_radius` есть постоянный кеш, поэтому повторные вызовы по тому же файлу отвечают сразу.

Нужен MCP-сервер agent-lsp: без него скилл не стартует. Ещё нужен языковой сервер с поддержкой `documentSymbolProvider`; `workspaceSymbolProvider` и `referencesProvider` желательны, но не обязательны. Лимиты жёсткие: не больше 30 пакетов, 10 файлов в анализе горячих точек и 5 запросов символов, а в `vendor/`, `node_modules/` и `.git/` рекурсии нет — на монорепозитории с сотней пакетов отчёт выйдет неполным, и это стоит учитывать заранее.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blackwell-systems/agent-lsp --skill lsp-architecture -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blackwell-systems/agent-lsp --skill lsp-architecture -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blackwell-systems/agent-lsp --skill lsp-architecture -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install blackwell-systems/agent-lsp lsp-architecture
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blackwell-systems/agent-lsp --skill lsp-architecture -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/blackwell-systems/agent-lsp --path skills/lsp-architecture
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add blackwell-systems/agent-lsp --skill lsp-architecture -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/blackwell-systems/agent-lsp/tree/HEAD/skills/lsp-architecture/SKILL.md

## Когда брать
- понять, из каких пакетов состоит незнакомый репозиторий
- найти точки входа в CLI и HTTP-обработчики
- оценить, какие файлы трогать опасно из-за числа вызовов
- посмотреть распределение кода по языкам
- получить схему зависимостей между пакетами перед рефакторингом

## Примеры запросов агенту
- Сделай обзор архитектуры проекта в `/home/user/myproject`
- Покажи карту пакетов и точки входа в текущей рабочей папке
- Найди горячие файлы и посчитай их blast radius

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

Из того же набора: [blackwell-systems/agent-lsp](https://affpapa.org/nevibecode/by/blackwell-systems/agent-lsp.md) — 9 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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