module-map — скилл для Claude Code: карта кодовой базы
Скилл module-map для Claude Code составляет компактную карту незнакомой части кодовой базы: точки входа, основные модули, поток данных и внешние вызывающие. Помогает быстро сориентироваться в чужом коде.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает module-map
В ответе идут краткое описание области, точки входа с путями и символами, основные модули, схема потока данных и внешние вызывающие. Отдельно скилл отмечает скрытые связи — например, общее состояние или неявный порядок вызовов. Каждый вывод должен опираться на путь к файлу и проверку через grep.
Карту нужно уместить на одном экране: если область слишком велика, скилл делит её на сегменты и спрашивает, какой раскрыть. Он не предлагает рефакторинг и намеренно не перечисляет все файлы. Без проверки через grep выводы о структуре делать нельзя.
Какие задачи решает
- найти точки входа в незнакомую часть проекта
- проследить основной поток данных от вызова до результата
- понять, какие модули содержат основную логику
- обнаружить общие состояния и неявные связи между файлами
Примеры запросов агенту
- Составь карту этой части кодовой базы: я пока не понимаю, как она устроена.
- Покажи точки входа и основной поток данных для этого модуля.
- Помоги сориентироваться: какие файлы вызывают эту область и от чего она зависит?
Как установить module-map
1Через маркетплейс плагинов
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflowКоманда ставит плагин pro-workflow целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill module-map -a claude-code3Вручную: положить файлы
~/.claude/skills/module-map/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/module-map/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill module-map -a codex2Вручную: положить файлы
.agents/skills/module-map/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill module-map -a cursor2Вручную: положить файлы
.cursor/skills/module-map/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/module-map2Вручную: положить файлы
.github/skills/module-map/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill module-map -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/module-mapВручную: положить файлы
.devin/skills/module-map/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о module-map
Как установить module-map в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add rohitg00/pro-workflow, затем установите плагин командой /plugin install pro-workflow@pro-workflow.
Что делает module-map?
Он собирает одностраничную карту выбранной области: точки входа, основные модули, поток данных, внешние вызовы и скрытые связи. Каждое утверждение должно подтверждаться путём к файлу и проверкой через grep.
Что произойдёт, если область кода не помещается на один экран?
Скилл разделит её на сегменты и спросит, какой из них раскрыть. Он не должен молча опускать часть кодовой базы.
Исходный текст
SKILL.md · MIT
--- name: module-map description: Produce a one-screen map of an unfamiliar area of the codebase: entry points, modules, data flow, callers. Designed to be read in fifteen seconds. Use when the user says "I do not know this area", "give me the map", "zoom out", "orient me". --- # module-map Orient fast in unfamiliar code. The deliverable is a map, not a tour. ## Deliverable A single response containing, in this order: 1. **One-line summary** of what the area does from a caller's point of view. 2. **Entry points** — every function, route, CLI command, event handler, or cron that starts a call chain in this area. File path + symbol. 3. **Core modules** — the two to five modules that contain the real logic. One line each describing their role. 4. **Data flow** — ASCII arrows showing the dominant path for the most common input. Skip error paths unless they matter architecturally. 5. **External callers** — who outside this area calls in, and through which entry points. 6. **Hidden coupling** — anything that looks independent but is not (shared singletons, global state, implicit ordering, undocumented contracts between files). ## Rules - Fifteen-second read target. If the map exceeds one screen, cut it. - Every claim must be backed by a file path. No remembered or inferred structure without a grep behind it. - Do not list every file. Curate. A good map omits deliberately. - Do not propose changes. Mapping is orientation; refactoring is a different skill. - If the area is too large to map in one screen, segment it and ask the user which segment to expand. Do not silently drop half the code. ## Format ``` AREA: <one-line summary> ENTRY POINTS - <path>:<symbol> — <role> CORE MODULES - <path> — <role> FLOW <entry> -> <module> -> <module> -> <sink> CALLERS - <path> — uses <entry> HIDDEN COUPLING - <description> (<path>) ``` Use the exact headers. Consistency lets the user scan.
© Rohit Ghumare · MIT · rohitg00/pro-workflow