arch-wiki — скилл
Скилл держит архитектурную вики в актуальном виде: сканирует код и пересобирает один HTML-дашборд с эндпоинтами и Docker.
- 273 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Агент читает исходники и пишет файлы в `docs/architecture`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/arch-wikiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Агент читает исходники и пишет файлы в `docs/architecture`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
arch-wiki — скилл, который по запросу агента читает манифест `architecture.json`, сканирует измененные файлы бэкенда и обновляет манифест. Затем скрипт `build_html.py` пересобирает один автономный HTML-файл с модулями API, эндпоинтами, схемой Docker, правами доступа, SQL-запросами и документацией Swagger. Первый запуск создает манифест сам: сканер читает `docker-compose.yml`, файлы маршрутов вроде `*.routes.ts` и `routers/*.py`, а также `package.json`. Манифест заодно служит агентам индексом проекта: вместо десятков чтений файлов хватает одного, а каждая запись ссылается на путь к исходнику.
Для кого. Бэкенд-разработчики, у которых документация по API и инфраструктуре устаревает быстрее кода, и команды, где агенту нужна карта проекта.
Подходит, если
- В проект добавили эндпоинт, и вики должна измениться сама.
- Новому коллеге нужна карта сервисов и Docker-топологии.
- Агент тратит токены на поиск маршрутов по сотням файлов.
- Права и SQL-запросы собирают в один каталог для ревью.
- Страницу архитектуры хотят отдать одним HTML-файлом без сервера.
Не подходит, если
- Проект без бэкенда и без маршрутов API.
- Нестандартные пути к маршрутам, которые сканер не находит.
- Нужна документация для внешних клиентов в формате OpenAPI-портала.
Пример запроса к агенту
Запусти скилл arch-wiki: я добавил модуль заказов, обнови манифест и пересобери дашборд.Ограничения
Автосканер рассчитан на типовые структуры, включая `docker-compose.yml`, маршруты Express и FastAPI, поэтому результат нужно просмотреть и дополнить. В README указан плейсхолдер `npx github:your-username/arch-wiki`, подставьте имя репозитория. Скрипт `build_html.py` копируется в `docs/architecture` вашего проекта. Права и SQL-запросы из кода попадают в общий HTML, поэтому не публикуйте страницу вне команды без проверки.
Как отключить. Удалите `~/.claude/skills/arch-wiki` (или аналог для вашего агента) и папку `docs/architecture` в проекте.
Частые вопросы
Что получается на выходе?
Один автономный файл `docs/architecture/architecture.html` и манифест `architecture.json`. HTML никогда не правят вручную.
Какие агенты подходят?
Claude Code, Cursor, Codex, OpenCode и Antigravity. README показывает установку для каждого.
Нужно ли запускать Python самому?
Нет. Агент сам копирует `build_html.py` в `docs/architecture` и запускает его.
Что умеет дашборд?
Показывает модули, эндпоинты, диаграммы Mermaid, права, SQL-запросы и интерактивный Swagger, а также выгружает страницу в PDF.
Чем манифест полезен агенту?
Одним чтением агент получает модули, эндпоинты, запросы и пути к исходникам, не обходя сотни файлов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл рисует интерактивную изометрическую карту репозитория: здания по размеру кода, потоки по реальным вызовам.
Скилл рисует архитектуру системы одной HTML-страницей: схема с панорамой, фокусом на узле, светлой и темной темой.
Скилл делает агента архитектурным тренером: вопросами ведет к ADR, схеме и плану развития, чужой репозиторий разбирает по коду
Скилл рисует архитектуру проекта, его правила и границы будущей правки на HTML-карте, чтобы согласовать план до изменения кода.
Строит интерактивные схемы архитектуры в одном HTML-файле: анимированные потоки данных, переключение сред и панель деталей шага
Git-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
Коротко о README
Манифест генерируется нулевой зависимостью-сканером и дополняется агентом. Дубли из `dist/`, `build/` и `node_modules/` отфильтровываются.