К основному содержанию
плагин CX Codex

codebase-recon — плагин для Claude Code: анализ истории Git

Плагин codebase-recon изучает историю Git, чтобы показать устройство проекта до чтения кода. Помогает найти часто меняющиеся и проблемные файлы, а также понять распределение знаний в команде.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codebase-recon@awesome-codex-plugins
Открыть на GitHub

Что делает codebase-recon

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

В отчёте есть рекомендации по итогам анализа. Для работы нужны git и репозиторий с историей коммитов; без истории Git плагину нечего анализировать. Запустите /codebase-recon перед тем, как разбираться в незнакомом проекте.

Какие задачи решает

  • найти файлы, которые часто меняются
  • выявить файлы, где часто исправляют ошибки
  • понять, на ком сосредоточены знания о проекте
  • оценить динамику разработки и частоту срочных исправлений
  • определить зоны повышенного риска по истории Git

Примеры запросов агенту

  • Проанализируй историю Git в этом репозитории и покажи файлы повышенного риска: /codebase-recon.
  • Перед чтением кода оцени, как менялся проект и кто вносил активные изменения: /codebase-recon.
  • Проверь, где сосредоточены знания о проекте и как часто нужны срочные исправления: /codebase-recon.

Как установить codebase-recon

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codebase-recon@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codebase-recon

Как установить codebase-recon в Claude Code?

Откройте браузер плагинов через /plugin.

Что делает codebase-recon?

Анализирует историю Git по семи аспектам, сопоставляет часто меняющиеся файлы с теми, где исправляют ошибки, и выдаёт рекомендации.

Что нужно для работы codebase-recon?

Нужны git любой версии и репозиторий с историей коммитов.

Исходный текст

codebase-recon-skill · MIT
# codebase-recon-skill

A coding agent skill that analyzes git history to understand a codebase before reading any code. Reveals project health, risk areas, team structure, and development momentum.

Inspired by ["The Git Commands I Run Before Reading Any Code"](https://piechowski.io/post/git-commands-before-reading-code/) by [Ally Piechowski](https://github.com/grepsedawk).

## Installation

### Via skills.sh (works with 20+ coding agents)

```sh
npx skills add yujiachen-y/codebase-recon-skill
```

Works with Claude Code, Cline, Cursor, GitHub Copilot, Gemini CLI, and any agent supporting the [Agent Skills Specification](https://agentskills.io/specification).

### Via Claude Code plugin system

```
/plugin marketplace add yujiachen-y/codebase-recon-skill
```

Then install the plugin from the marketplace browser via `/plugin`.

### Via Codex plugin system

```sh
codex plugin marketplace add yujiachen-y/codebase-recon-skill
```

Then run `/plugins` in Codex, choose the `Codebase Recon` marketplace, and install `codebase-recon`.

## Usage

In your coding agent, invoke:

```
/codebase-recon
```

The skill will:
1. **Probe** the repo to determine its scale (small / medium / large)
2. **Analyze** 7 dimensions in parallel: code hotspots, bus factor, bug magnets, team momentum, firefighting frequency, recently added files, and active contributors
3. **Cross-reference** hotspots with bug magnets to identify high-risk files
4. **Report** findings with actionable recommendations

## What You'll Learn

| Dimension | Question Answered |
|-----------|-------------------|
| Code Hotspots | Which files change the most? |
| Bug Magnets | Which files attract the most bug fixes? |
| High-Risk Files | Which files are both hot AND buggy? |
| Bus Factor | Who knows what? Is knowledge concentrated? |
| Team Momentum | Is development accelerating, stable, or declining? |
| Firefighting | How often are there emergency fixes and reverts? |
| Recently Added | Where is active development happening? |

## Requirements

- `git` (any version)
- A git repository with commit history

## Attribution

This skill is inspired by ["The Git Commands I Run Before Reading Any Code"](https://piechowski.io/post/git-commands-before-reading-code/) by [Ally Piechowski](https://github.com/grepsedawk). The original article describes 5 git commands for codebase reconnaissance. This skill extends the concept with auto-scaling, cross-referencing, and actionable recommendations.

## License

[MIT](LICENSE)

© Jiachen Yu · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Git и GitHub» →
acquire-codebase-knowledge официальный github Скилл acquire-codebase-knowledge для GitHub Copilot изучает существующий репозиторий и готовит документацию по его устройству. Запускается по просьбе описать архитектуру, составить карту проекта или помочь освоиться в кодовой базе. CX Codex +1 2 200установок codebase-onboarding Alireza Rezvani Скилл codebase-onboarding для Claude Code анализирует репозиторий и собирает материалы для знакомства с проектом. Запускается при адаптации нового инженера и подготовке архитектурного обзора. CX Codex +1 698установок codebase-explorer davila7 Субагент codebase-explorer исследует незнакомый проект: находит стек, архитектуру, точки входа и поток данных. По запросу сохраняет выводы в CLAUDE.md. CX Codex 256установок codebase-map dotslashsimran Скилл codebase-map для Claude Code разбирает незнакомый репозиторий и собирает карту его архитектуры. Запускается по просьбе объяснить устройство проекта или проследить путь запроса. CX Codex +1 ★ 541звёзд репо agent-3-codebase-explorer happycapy-ai Субагент agent-3-codebase-explorer исследует репозиторий перед исправлением или новой функцией: находит нужные файлы, разбирает структуру и готовит карту кодовой базы. CX Codex ★ 138звёзд репо bmad-deep-recon bmad-code-org Скилл bmad-deep-recon для глубокого ресёрча: готовит промпт, обрабатывает отчёт или сам собирает данные по теме и по вашему репозиторию. CX Codex +1 17 100установок

Из того же набора391

Весь набор →
codex-auto-resume Плагин codex-auto-resume для Claude Code и Codex отслеживает лимиты Codex в Windows, ждёт сброса и автоматически возобновляет ту же сессию через codex queue. CX Codex ★ 1 596звёзд репо codex-agents-workflow Плагин codex-agents-workflow для Claude Code помогает собирать и запускать повторно используемые рабочие процессы агентов. Включается для настройки ролей и провайдеров или восстановления запусков. CX Codex ★ 1 596звёзд репо ateam Плагин ateam превращает Codex в команду из шести ролей: исследователь, PM, архитектор, разработчик, QA и ревьюер. Пайплайн настраивается, роли вызываются упоминанием. CX Codex ★ 1 596звёзд репо codetruss Плагин codetruss для Claude Code и Codex задаёт границы файлов агента и проверяет изменения локальными анализаторами, формируя подписанные чеки ревью. CX Codex ★ 1 596звёзд репо clueless Плагин clueless для Claude Code включает режим, в котором агент отвечает так, будто проверять его работу некому. Сначала он выделяет необратимые шаги, затем предлагает одну проверку. CX Codex ★ 1 596звёзд репо click Плагин click управляет инкрементальным запуском тестов в Claude Code и Codex. Пропускает нетронутые проверки и выдаёт короткие квитанции вместо длинных логов. CX Codex ★ 1 596звёзд репо clean-room Плагин clean-room разделяет анализ разрешённого исходного кода и чистую реализацию. Он пригодится для подготовки поведенческих спецификаций без переноса исходных материалов в код. CX Codex ★ 1 596звёзд репо claudemon Плагин claudemon превращает агентов Claude в пиксельных существ: за ними видно работу в файлах, а в перерывах открывается Clawland, одиночный .io-бравлер. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой