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

cpg-analysis — скилл для Claude Code: анализ кода и установка

Скилл cpg-analysis для Claude Code анализирует потоки управления и данных через Joern CPG и CodeQL. Применяется при сложном рефакторинге и аудите безопасности.

MIT 175 установок ★ 713 обновлён 2026-10-13

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

Что делает cpg-analysis

Скилл разбирает код глубже обычного AST. Joern строит Code Property Graph с графами управления, зависимостей и потока данных: можно искать пути выполнения, мёртвый код, цепочки вызовов и влияние сложного рефакторинга. Для запросов доступны инструменты CodeBadger MCP, включая generate_cpg, get_cfg, run_cpgql_query и get_call_graph.

CodeQL добавляет межпроцедурный taint-анализ и поиск уязвимостей, включая потоки от пользовательского ввода к SQL-запросу или перенаправлению. Для Joern нужны Docker и Python 3.10+, для CodeQL — CodeQL CLI. Установка выполняется через ~/.claude/install-graph-tools.sh --joern или ~/.claude/install-graph-tools.sh --codeql. Для Rust нужен CodeQL, потому что Joern этот язык не поддерживает.

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

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

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

  • Построй граф вызовов для метода login и покажи связанные функции.
  • Проследи путь пользовательского ввода до SQL-запроса и проверь проект на инъекцию.
  • Найди мёртвые методы и участки кода, которые нельзя достичь из main.

Как установить cpg-analysis

1Через Skills CLI (Vercel)

npx skills add alinaqi/maggy --skill cpg-analysis -a claude-code

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

~/.claude/skills/cpg-analysis/SKILL.md

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

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

Вопросы о cpg-analysis

Как установить cpg-analysis в Claude Code?

Выполните npx skills add alinaqi/maggy --skill cpg-analysis -a claude-code. Файл скилла появится по пути ~/.claude/skills/cpg-analysis/SKILL.md.

Что делает cpg-analysis?

Скилл использует Joern CPG для анализа управления, зависимостей и потоков данных, а CodeQL — для межпроцедурного taint-анализа и поиска уязвимостей.

Что нужно для работы cpg-analysis?

Для Joern нужны Docker и Python 3.10+. Для CodeQL нужен CodeQL CLI; Rust анализируется через CodeQL, поскольку Joern его не поддерживает.

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

SKILL.md · MIT
---
name: cpg-analysis
description: Deep code property graph analysis with Joern CPG (AST+CFG+PDG) and CodeQL for control flow, data flow, taint analysis, and security auditing
when-to-use: "When deep code analysis is needed — control flow, data flow, taint tracking, or security auditing"
user-invocable: true
effort: high
---

# CPG Analysis Skill


**Purpose:** Deep code analysis beyond AST. Use Joern for full Code
Property Graph (control flow, data flow, program dependencies) and CodeQL
for interprocedural taint analysis and vulnerability detection.

**These are opt-in tools.** They require Docker/JVM (Joern) or CodeQL CLI.
Use codebase-memory-mcp (Tier 1, always-on) for everyday navigation.
Use these for deep analysis when Tier 1 is not enough.

```
┌────────────────────────────────────────────────────────────────┐
│  CODE PROPERTY GRAPH = AST + CFG + CDG + DDG + PDG             │
│  ─────────────────────────────────────────────────────────────│
│  AST  = Abstract Syntax Tree (structure)                       │
│  CFG  = Control Flow Graph (execution paths)                   │
│  CDG  = Control Dependency Graph (conditional dependencies)    │
│  DDG  = Data Dependency Graph (data flow between statements)   │
│  PDG  = Program Dependency Graph (CDG + DDG combined)          │
│                                                                │
│  Tier 2 (Joern): Full CPG with 40+ query tools                │
│  Tier 3 (CodeQL): Interprocedural taint + security queries     │
└────────────────────────────────────────────────────────────────┘
```

---

## Tier Selection Guide

```
Simple symbol lookup, dependency trace, blast radius?
  → Tier 1: codebase-memory-mcp (always on, sub-ms)

Control flow paths, data flow, dead code, complex refactoring?
  → Tier 2: Joern CPG (on-demand, seconds)

Security audit, taint analysis, vulnerability detection?
  → Tier 3: CodeQL (on-demand, seconds to minutes)

Full security review before release?
  → All three tiers in sequence
```

---

## Tier 2: Joern CPG (CodeBadger MCP)

### When to Use Joern

| Scenario | Why Joern | Tier 1 Can't Do This |
|----------|-----------|---------------------|
| Trace data flow through functions | Full DDG traversal | Tier 1 has no data flow |
| Understanding control flow paths | CFG analysis with branch conditions | Tier 1 has no CFG |
| Finding dead/unreachable code | PDG reachability analysis | Tier 1 only detects unused exports |
| Complex refactoring impact | Cross-function dependency chains | Tier 1 limited to call graph |
| Auditing third-party library usage | Deep call chain traversal | Tier 1 stops at import boundary |
| Understanding exception flow | CFG includes throw/catch paths | Tier 1 ignores exceptions |

### Key MCP Tools (Joern/CodeBadger)

| Tool | Purpose | Example Query |
|------|---------|---------------|
| `generate_cpg` | Build CPG for project | First-time setup or after major changes |
| `get_cpg_status` | Check CPG build status | Verify CPG is ready before querying |
| `run_cpgql_query` | Run arbitrary CPGQL queries | `cpg.method("login").callOut.code.l` |
| `get_cpgql_syntax_help` | Query language reference | When unsure about query syntax |
| `get_cfg` | Control flow graph for a method | Understand execution paths in a function |
| `list_methods` | List all methods in project | Overview of available functions |
| `get_method_source` | Get source code of a method | Read specific function source |
| `list_calls` | List calls from/to a method | Caller/callee analysis |
| `get_call_graph` | Full call graph visualization | Understand call chains |
| `get_type_definition` | Type/class definitions | Understand type hierarchy |

### Supported Languages (Joern)

Java, Scala, C/C++, Python, JavaScript, TypeScript, PHP, Ruby, Go,
Kotlin, Swift, Lua

**Not supported:** Rust (use CodeQL for Rust)

### MCP Configuration (Joern)

```json
{
  "mcpServers": {
    "codebadger": {
      "url": "http://localhost:4242/mcp",
      "type": "http"
    }
  }
}
```

### Prerequisites

- Docker (for Joern backend)
- Python 3.10+ (for MCP server)
- Install: `~/.claude/install-graph-tools.sh --joern`

### Common CPGQL Queries

```scala
// Find all methods that handle user input
cpg.method.where(_.parameter.name(".*input.*|.*request.*")).name.l

// Trace data flow from parameter to return
cpg.method("processPayment").parameter.reachableBy(cpg.method("processPayment").methodReturn).l

// Find methods with high cyclomatic complexity
cpg.method.where(_.controlStructure.size > 10).name.l

// Dead code: methods with no callers
cpg.method.where(_.callIn.size == 0).filter(_.name != "main").name.l

// Exception flow: methods that can throw but callers don't catch
cpg.method.where(_.ast.isThrow.size > 0).callIn.method.filter(_.ast.isTry.size == 0).name.l
```

---

## Tier 3: CodeQL

### When to Use CodeQL

| Scenario | Why CodeQL | Other Tiers Can't Do This |
|----------|-----------|--------------------------|
| Security audit before release | Interprocedural taint analysis | Joern has basic taint, CodeQL is deeper |
| Reviewing auth/payment code | Data flow from source to sink | Cross-function, cross-file taint |
| PR security review | Targeted vulnerability scan | Pre-built OWASP query packs |
| Compliance checking | CWE/OWASP pattern matching | Curated security query suites |
| Rust security analysis | Full Rust support | Joern doesn't support Rust |

### Key MCP Tools (CodeQL)

| Tool | Purpose |
|------|---------|
| `run_query` | Execute a CodeQL query against the database |
| `find_definitions` | Locate symbol definitions |
| `find_references` | Find all references to a symbol |
| `get_results` | Parse BQRS (Binary Query Result Sets) |

### Supported Languages (CodeQL)

C/C++, C#, Go, Java, Kotlin, JavaScript, TypeScript, Python, Ruby,
Swift, **Rust**

### MCP Configuration (CodeQL)

```json
{
  "mcpServers": {
    "codeql": {
      "command": "codeql-mcp",
      "args": ["--database", ".code-graph/codeql-db"]
    }
  }
}
```

### Prerequisites

- CodeQL CLI (`brew install codeql` on macOS)
- Install: `~/.claude/install-graph-tools.sh --codeql`

### Common CodeQL Patterns

```ql
// SQL injection: user input flows to SQL query
import python
from DataFlow::PathNode source, DataFlow::PathNode sink
where TaintTracking::hasFlowPath(source, sink)
  and source instanceof RemoteFlowSource
  and sink instanceof SqlExecution
select sink, source, sink, "SQL injection from $@.", source, "user input"

// Unvalidated redirect
from DataFlow::PathNode source, DataFlow::PathNode sink
where source instanceof RemoteFlowSource
  and sink instanceof RedirectSink
select sink, "Unvalidated redirect from user input"
```

---

## Combined Workflow: Deep Analysis

When performing security review or complex refactoring, use all tiers:

```
1. SCOPE       → Tier 1: detect_changes / get_architecture
                 Identify files and modules in scope

2. STRUCTURE   → Tier 1: search_graph / trace_call_path
                 Map the call graph and dependencies

3. FLOW        → Tier 2: get_cfg / run_cpgql_query
                 Analyze control flow and data flow paths

4. SECURITY    → Tier 3: run_query with taint analysis
                 Check for vulnerabilities in data paths

5. REPORT      → Combine findings from all tiers
                 Prioritize: Critical > High > Medium > Low
```

---

## Anti-Patterns

| Anti-Pattern | Do This Instead |
|-------------|-----------------|
| Using Joern/CodeQL for simple symbol lookup | Use Tier 1 `search_graph` (sub-ms vs seconds) |
| Running full CPG build on every commit | Build CPG on-demand; use Tier 1 for continuous monitoring |
| Querying Joern without checking `get_cpg_status` | Always verify CPG is built and current before querying |
| Running CodeQL without a specific security question | Have a hypothesis first; CodeQL queries are expensive |
| Ignoring Tier 1 blast radius before deep analysis | Always scope with Tier 1 first, then go deep on flagged areas |
| Using CodeQL for non-security structural queries | Use Joern CPGQL for structural/flow queries; CodeQL for security |

© alinaqi · MIT · alinaqi/maggy

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

Все скиллы по теме «Безопасность» →
gitnexus-taint-analysis abhigyanpatwari Скилл gitnexus-taint-analysis для Claude Code и Codex: разбирает устройство подсистемы taint-анализа в GitNexus — CFG, reaching definitions, источники и стоки. Объясняет находки и добавление новых source/sink. CX Codex +1 421установок sast-flow-tracer H-mmer Субагент sast-flow-tracer отслеживает пути прохождения данных от точек входа до опасных операций в кодовой базе и проверяет цепочки валидации. CX Codex +1 ★ 1 298звёзд репо variant-analysis trailofbits Скилл variant-analysis ищет в репозитории другие проявления уже найденной ошибки. Нужен после уязвимости или логического дефекта, когда требуется проверить похожий код. CX Codex +1 7 400установок Lachesis UnboundCompute MCP-сервер Lachesis для Claude Code и других агентов. Строит граф свойств кода для C, Python и TypeScript, отвечает на вопросы о потоках данных и ищет пути, по которым внешний ввод доходит до опасных операций без проверок. CX Codex +1 ★ 6звёзд репо attack-path-analysis официальный OpenAI Скилл attack-path-analysis для Codex анализирует пути атак и определяет критичность найденных уязвимостей. Используется для трассировки пути от источника к точке входа или в ходе сканирования безопасности. CX Codex GP ChatGPT +1 27установок gitnexus-impact-analysis abhigyanpatwari Скилл gitnexus-impact-analysis для Claude Code оценивает радиус влияния правок перед рефакторингом. Находит прямых и косвенных потребителей функции или файла через GitNexus. CX Codex +1 2 000установок

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

Весь набор →
base Скилл base задаёт правила чистого кода, лимиты на размер файлов и строгий TDD-процесс для ИИ-агентов. CX Codex +1 276установок shopify-apps Скилл shopify-apps помогает собирать приложения Shopify на Remix, работать с Admin GraphQL API и создавать checkout-расширения. Пригодится при разработке приложения или расширения для магазина. CX Codex +1 273установок azure-cosmosdb Скилл Claude Code разбирает partition keys, консистентность, change feed и паттерны SDK для Azure Cosmos DB; содержит примеры CRUD, иерархических ключей и cross-partition запросов. CX Codex +1 269установок workspace Скилл workspace анализирует архитектуру монорепозиториев и связанных проектов. Находит общие контракты API и типы, чтобы агент не ломал связи между сервисами. CX Codex +1 198установок icpg Скилл icpg отслеживает, ПОЧЕМУ существует каждая функция и модуль, через граф причин (ReasonNodes) с формальными контрактами. CX Codex +1 156установок mnemos Скилл mnemos, который предотвращает потерю важной информации при компакции контекста. Структурирует рабочую память как типизированный граф, где решения и цели никогда не теряются, а менее важные данные сжимаются по правилам. CX Codex +1 134установок maggy Скилл maggy для Claude Code собирает тикеты GitHub Issues и Asana в один инбокс, запускает TDD-прогон из тикета и готовит ежедневную сводку по конкурентам. CX Codex +1 131установок cross-agent-delegation Скилл cross-agent-delegation маршрутизирует задачи между Claude, Kimi и Codex на основе оценки сложности, чекпоинтов Mnemos и графа iCPG. CX Codex +1 122установок

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

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