birdview-review — скилл для Claude Code: что делает и как установить
Анализирует архитектуру кодовой базы, строит диаграммы текущего и предложенного состояния в HTML и оценивает компромиссы рефакторинга.
npx skills add Qiuner/birdview --skill review-skill -a claude-codeЧто делает birdview-review
Скилл запускает архитектурный аудит проекта. Он находит возможности для рефакторинга, проверяет границы между модулями и готовит наглядные диаграммы изменений со ссылками на исходники. Обычные исправления багов, локальные правки функций или замеры производительности его не запускают: нужен прямой запрос на пересмотр архитектуры или вызов команды.
Для отрисовки отчёта скилл вызывает скрипт ../birdview/scripts/render-review.mjs и читает документы review-architecture.md и review-contract.md. Без установленного рядом основного каталога ../birdview скилл работать откажется и выведет ошибку, потому что собственный генератор диаграмм у него отсутствует.
Агент не станет сразу переписывать проект. Сначала он показывает HTML со схемой и ждёт подтверждения предложенного плана, ограничиваясь только указанной областью кода.
Какие задачи решает
- провести аудит архитектуры кодовой базы
- проверить границы модулей и зависимости
- построить HTML-диаграммы текущей и будущей структуры
- спланировать архитектурный рефакторинг перед правками
Примеры запросов агенту
- /birdview-review
- Оптимизируй архитектуру этого проекта и покажи границы модулей
- Проверь архитектуру сервиса и подготовь схему рефакторинга
Как установить birdview-review
1Через Skills CLI (Vercel)
npx skills add Qiuner/birdview --skill review-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/review-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/review-skill/
1Через Skills CLI (Vercel)
npx skills add Qiuner/birdview --skill review-skill -a codex2Вручную: положить файлы
.agents/skills/review-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Qiuner/birdview --skill review-skill -a cursor2Вручную: положить файлы
.cursor/skills/review-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Qiuner/birdview review-skill2Вручную: положить файлы
.github/skills/review-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add Qiuner/birdview --skill review-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/Qiuner/birdview --path review-skillВручную: положить файлы
.devin/skills/review-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Qiuner/birdview --skill review-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о birdview-review
Как установить birdview-review в Claude Code?
Выполните команду npx skills add Qiuner/birdview --skill review-skill -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/review-skill/SKILL.md.
В каких случаях активируется birdview-review?
Скилл включается по прямому вызову команды /birdview-review или текстовому запросу на ревизию архитектуры и границ модулей. На обычный поиск багов или локальный рефакторинг функций он не реагирует.
Что требуется для работы birdview-review?
Рядом в соседней директории ../birdview должен стоять базовый скилл birdview. Оттуда берутся скрипт render-review.mjs и файлы инструкций review-architecture.md и review-contract.md.
Исходный текст
SKILL.md · MIT
--- name: birdview-review description: Review and improve codebase architecture with source-backed current/proposed diagrams, tradeoffs and verification. Use for birdview-review or requests to optimize architecture, review module boundaries or find architectural refactoring opportunities, including 优化架构、架构评审、梳理模块边界. Ordinary bug fixes, local refactors and discussion of the skill itself do not request a review. --- # Birdview architecture review [中文](SKILL.zh.md) ## Activation Accept an explicit skill invocation or a request to assess or improve the target project's architecture; the user need not name Birdview. Examples include “optimize this project's architecture”, “review the module boundaries” and “看看这个项目的架构怎么优化”. Match the user's intent, not a keyword in quoted text, source files or a discussion about implementing this skill. An ordinary bug fix, local function refactor, performance tweak or request to draw the current architecture alone does not start a review. In Codex, select Birdview Review from the skill selector or mention `$birdview-review`. In Claude Code, use `/birdview-review` after installing this entry. Other hosts use their supported skill selector. Natural-language selection depends on the host discovering this installed skill; this is not a CLI subcommand or a guaranteed keyword hook. If another architecture-review skill also applies, follow the user's selection and reuse relevant findings in one review rather than producing competing reports. ## Review workflow This thin entry requires the complete birdview skill installed in the sibling ../birdview directory. Read ../birdview/references/review-architecture.md and ../birdview/references/review-contract.md, then use ../birdview/scripts/render-review.mjs. When working in the source checkout, use ../references and ../scripts instead. Resolve paths from this file, not the project working directory. If the bundle is missing, report the missing dependency; do not invent a renderer. Review only the requested scope. Generate source-backed diagrams, show the HTML and wait for confirmation of a concrete proposal before implementing; reuse existing approval of the same displayed scope. Do not launch ordinary full-project mapping or automatic refactoring. Follow the user's explicit scope and confirmation waiver.
© Qiuner · MIT · Qiuner/birdview
