Menu
Understand a file or symbol's structure and dependencies using code intelligence tools
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | understand |
| description | Understand a file or symbol's structure and dependencies using code intelligence tools |
| allowed-tools | ["mcp__gitkb__kb_symbols","mcp__gitkb__kb_callers","mcp__gitkb__kb_callees","mcp__gitkb__kb_symbol_refs"] |
Analyze a file or symbol using code intelligence tools to understand its structure and dependencies.
When the argument looks like a file path (e.g., src/services/auth.ts):
List symbols in the file:
kb_symbols with file_path: "src/services/auth.ts"
For key functions/methods, show their connections:
kb_callers with symbol: "src/services/auth.ts::login"
kb_callees with symbol: "src/services/auth.ts::login"
Check if any documents reference this code:
kb_symbol_refs with symbol: "src/services/auth.ts::login"
When the argument contains :: or looks like a function name:
Find the symbol:
kb_symbols with search: "login"
Show callers (who calls this):
kb_callers with symbol: "src/services/auth.ts::login"
Show callees (what this calls):
kb_callees with symbol: "src/services/auth.ts::login"
Find related documents:
kb_symbol_refs with symbol: "src/services/auth.ts::login"
Provide a summary with:
Input: /understand src/services/auth.ts
Output:
## src/services/auth.ts - Authentication Module
### Symbols (5)
- `login(credentials: Credentials): Promise<Token>` (function)
- `logout(token: Token): Promise<void>` (function)
- `validateToken(token: Token): boolean` (function)
- `AuthConfig` (interface)
- `AuthError` (class)
### Key Function: login()
**Callers (3):**
- src/routes/auth.ts:45 → handleRequest()
- src/routes/auth.ts:89 → handleRefresh()
- src/middleware/auth.ts:22 → authenticate()
**Callees (2):**
- src/db/users.ts::findUser()
- src/crypto/tokens.ts::generateToken()
### Related Documents
- tasks/my-task (Auth Service Refactoring)
Code must be indexed first:
git kb index
Safety check before refactoring - shows callers, callees, and impact analysis
Explore codebase semantically - find relevant code and documents using natural language search
Manage GitKB knowledge base for project documentation, tasks, and context. Use when working with KB documents, viewing tasks, updating progress, or managing project knowledge.
Manage isolated git worktree sets for multi-repo tasks.
Execute commands across all repos — parallel, filtered, dry-run modes.
Git operations across multiple repositories — status, commit, push, pull, snapshots, multi-commit.