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

code-understand — скилл для Claude Code: что делает и как установить

Скилл code-understand строит карту ключевых символов и связей в незнакомом коде перед правками. Помогает оценить зону поражения изменений и найти вызывающие функции.

MIT 226 установок ★ 3 795 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Ar9av/obsidian-wiki --skill code-understand -a claude-code
Открыть на GitHub

Что делает code-understand

Скилл запускает команду obsidian-wiki code-understand, чтобы составить карту архитектурных узлов проекта: ключевые символы и зависимости. Вместо сплошного чтения репозитория агент получает список точек входа с точными ссылками file:line. Это ускоряет погружение перед рефакторингом или оценкой изменений.

Анализ работает через два бэкенда. В режиме auto скилл проверяет наличие глобального пакета @colbymchenry/codegraph и строит строгий граф вызовов. Если пакета нет, запускается встроенный движок на регулярных выражениях AST и утилите rg. При работе со встроенным бэкендом текстовые ссылки rg-reference требуют ручной проверки в файле, так как не гарантируют строгую связь между вызовами.

Флаги --changed и --since сужают область поиска до нужного диффа или ветки, а --max-symbols задаёт лимит вывода (советует начать с 50 символов). Если утилита obsidian-wiki в системе не установлена, скилл завершится с ошибкой и агенту придётся вернуться к обычному поиску через grep.

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

  • понять структуру незнакомого проекта перед внесением правок
  • найти вызывающие функции и оценить зону поражения рефакторинга
  • отфильтровать архитектурные связи только по изменённым файлам диффа
  • проверить доступные анализаторы через команду obsidian-wiki doctor

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

  • Покажи карту вызовов для функции processPayment перед рефакторингом.
  • Оцени зону влияния изменений в файлах из последнего коммита через code-understand.
  • Составь список опорных символов проекта с лимитом --max-symbols 25.

Как установить code-understand

1Через Skills CLI (Vercel)

npx skills add Ar9av/obsidian-wiki --skill code-understand -a claude-code

2Вручную: положить файлы

~/.claude/skills/code-understand/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/code-understand/

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

Вопросы о code-understand

Как установить code-understand в Claude Code?

Выполните команду npx skills add Ar9av/obsidian-wiki --skill code-understand -a claude-code. Файл навыка запишется по пути ~/.claude/skills/code-understand/SKILL.md.

Что делает code-understand?

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

Обязательно ли ставить пакет CodeGraph?

Нет, без @colbymchenry/codegraph скилл автоматически переходит на встроенный движок с поиском через AST-регулярки и rg. Однако точный граф межфайловых вызовов доступен только с CodeGraph.

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

SKILL.md · MIT
---
name: code-understand
description: >
  Map the load-bearing files, symbols, callers, and dependencies of an unfamiliar codebase before making changes. Use for architecture orientation, impact analysis, what-would-break questions, or finding callers. Uses CodeGraph when available and a dependency-free builtin fallback.
---

# Code Understand — On-Demand Architecture Focus Map

You are about to work in a codebase you don't fully know yet. Instead of grepping around or
reading files at random, ask the local extractor for a **focus map**: the ranked symbols the
architecture hangs on, each with a `file:line` citation and evidence type. Read only what it
points at — this is a map, not a substitute for reading the actual code it cites.

## When to reach for this

- Before editing an unfamiliar module — see what calls it and what it calls before changing
  its shape.
- The user asks "how does X work", "what's the impact of changing Y", "who else uses this
  function" for a codebase, not the wiki.
- You're about to do a large refactor and want a ranked list of load-bearing files instead of
  reading the whole tree.
- You already have a diff or a set of changed files and want to know their blast radius before
  finishing the change.

Not for: summarizing what a project *does* for the wiki (that's `wiki-update` Step 3b, which
calls this same command as part of a bigger sync flow) — use this skill directly only when you
need the focus map for your own immediate work, not to persist knowledge.

## Running it

```bash
obsidian-wiki code-understand --project <dir> [--backend auto|builtin|codegraph] \
    [--changed <file>...] [--since <sha>] [--max-symbols N] [--pretty]
```

- `--project` — defaults to the current directory.
- No `--changed`/`--since` — seeds from every tracked file (full-project scan).
- `--changed <file>` (repeatable) — seed from specific files you already know are relevant
  (e.g. files in the diff you're about to make).
- `--since <sha>` — seed from everything changed since a git ref (e.g. `--since HEAD~5` or a
  base branch).
- `--backend` — `auto` (default) uses CodeGraph when installed, falls back to the builtin
  extractor otherwise; force `builtin` for the dependency-free path, or `codegraph` to require
  the enhanced backend (fails loudly if it's not installed rather than silently degrading).
- `--max-symbols` — cap the focus map size (default 50); keep this small for a quick
  orientation pass, raise it for a thorough one.

**GUARD:** if the command is unavailable or errors, skip it and fall back to your normal
exploration (grep/read) — this is an accelerant, not a dependency. Don't block work on it.

## Reading the output

1. **Evidence type matters.** When `backend: codegraph`, focus-map entries are structural
   facts (real call-graph edges) — cite them directly. When `backend: builtin`, `defines`/
   `imports`/`changed-file` entries are facts, but `rg-reference` entries are text-match
   evidence only — open the file and confirm before treating it as a real relationship.
2. **Open what it cites, nothing else first.** The focus map tells you *where* to read; it
   never contains source bodies. Go read those `file:line` locations before forming an opinion
   on the architecture.
3. **Cite it in your own output.** If you explain the architecture back to the user or write
   it into a PR description/commit message, keep the `(file:lines)` citations from the focus
   map or from the source you opened — don't assert structure without a pointer to it.
4. **It's a cache, not a deliverable.** Never write the raw JSON or `.codegraph/` into the
   wiki vault, a PR description, or committed docs — it's a disposable sidecar in the project
   repo (git-ignored). Re-run it fresh next time rather than treating old output as durable.

## If CodeGraph isn't installed

`auto`/`builtin` still work with zero setup (uses the regex AST extractor + `rg`). If you want
the enhanced cross-file call-graph evidence and the user is fine with installing something:

```bash
npm install -g @colbymchenry/codegraph
```

or point `CODE_UNDERSTANDING_CODEGRAPH_BIN` at an existing binary. Never install without the
user's go-ahead — ask first, then re-run the command.

Check `obsidian-wiki doctor --project <dir>` for the `code-understanding.*` capability lines
(`builtin`, `rg`, `codegraph`, `codegraph-index`, `codegraph-fresh`, `codegraph-gitignore`) to
see what's available before deciding which backend to request explicitly.

© Ar9av · MIT · Ar9av/obsidian-wiki

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
understand Egonex-AI Скилл understand для Claude Code анализирует кодовую базу и строит интерактивный граф знаний. Запускается для разбора архитектуры, компонентов и связей проекта. CX Codex +1 6 100установок understand-anything Egonex-AI Плагин understand-anything сканирует проект и строит интерактивный граф файлов, классов и зависимостей с веб-дашбордом. Пригодится при знакомстве с чужим или крупным кодом. ★ 93 566звёзд репо ast-grep-find parcadei Скилл ast-grep-find для Claude Code ищет код по синтаксическому дереву и заменяет конструкции с учётом структуры языка. Выполняет точечный рефакторинг функций, импортов и переменных без ложных срабатываний в строках. CX Codex +1 524установок tldr-deep parcadei Скилл tldr-deep разбирает отдельную функцию по пяти аналитическим слоям через утилиту tldr. Помогает при отладке и рефакторинге запутанного кода. CX Codex +1 485установок jscodeshift pproenca Набор правил для написания и отладки кодмодов на jscodeshift: разбор AST, миграции кода, авторефакторинг. CX Codex +1 422установок jscpd kucherenko Скилл jscpd находит дубликаты кода более чем на 220 языках и готовит компактный отчёт для ИИ-агента. Пригодится при рефакторинге и поиске скрытой копипасты. CX Codex +1 2 800установок

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

Весь набор →
pi-history-ingest Скилл pi-history-ingest для Claude Code переносит историю сессий Pi в Obsidian, собирая решения и команды из JSONL. Сохраняет опыт кодинга в личную базу знаний. CX Codex +1 1 200установок wiki-import Скилл wiki-import для Claude Code переносит граф вики в текущее хранилище Obsidian из graph.json или набора OKF с файлами Markdown. Он разбирает конфликты с уже существующими страницами. CX Codex +1 1 000установок vault-skill-factory Скилл vault-skill-factory для Claude Code собирает переиспользуемый Agent Skill из зрелых страниц вики или записи рабочего процесса. Готовый пакет попадает в папку для проверки, а не устанавливается автоматически. CX Codex +1 758установок vault-skill-factory Скилл vault-skill-factory собирает переносимый Agent Skill из зрелых страниц вики Obsidian и кладёт его в каталог на проверку. Установку оставляет человеку. CX Codex +1 758установок obsidian-layout-adjustment Скилл obsidian-layout-adjustment правит внешний вид Obsidian через CSS-сниппеты: переводит ваше описание элемента в нужный слой интерфейса, вносит правку и проверяет её по скриншоту. CX Codex +1 487установок wiki-narrate Скилл wiki-narrate для Claude Code собирает сводки, объяснения и лекции строго по заметкам Obsidian со ссылками на источники. Готовит отчёты без домыслов и выхода за рамки базы знаний. CX Codex +1 403установок session-search Скилл session-search ищет прошлые диалоги с агентом через граф session-brain и загружает стенограмму в текущую беседу. Пригодится, чтобы вспомнить решение давней задачи. CX Codex +1 367установок session-brain Скилл session-brain для Claude Code строит интерактивный граф тем по истории сессий без записи в хранилище заметок. Кластеризует диалоги и показывает связи между старыми задачами. CX Codex +1 364установок

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

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