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

graph · yeachan-heo — скилл для Claude Code: DAG-пайплайны с восстановлением

Скилл graph запускает многошаговые пайплайны как ориентированные графы и после сбоя продолжает работу по журналу с незавершённых узлов.

MIT 285 установок ★ 40 997 обновлён 2026-10-24

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

Что делает graph

Скилл graph выполняет пайплайны, описанные в JSON с узлами (команды, агенты, утверждения) и рёбрами между ними. Каждый шаг имеет таймаут и лимит попыток; граф расчитывает зависимости и параллелит там, где можно. Команды работают через omc graph run, агенты — в режиме только для чтения.

Восстановление после сбоя работает по журналу: если процесс упадёт или его убить, повторный запуск той же команды пропустит выполненные узлы и продолжит со следующих. Поэтому граф подходит для длинных, надёжных конвейеров, но не для работы, которая требует адаптации по ходу дела.

Утверждающие узлы (human-approval) работают только в интерактивном сеансе: через ! префикс, чтобы stdin доступен. Запуск через Bash-инструмент такие графы не поддержит. Все запуски пишут журнал и снимки в .omc/graph-runs/<run_id>/.

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

  • Запустить повторяемый конвейер с явными зависимостями
  • Возобновить прерванный процесс без повторного выполнения готовых шагов
  • Координировать команды и агентов в одной цепочке
  • Пропустить промежуточный узел на утверждение оператора

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

  • /oh-my-claudecode:graph build-and-test.json
  • Запусти граф для сборки, тестирования и развёртывания из deploy.json
  • Возобнови граф run-123 после сбоя

Как установить graph

1Через Skills CLI (Vercel)

npx skills add Yeachan-Heo/oh-my-claudecode --skill graph -a claude-code

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

~/.claude/skills/graph/SKILL.md

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

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

Вопросы о graph

Как установить graph в Claude Code?

Выполни npx skills add Yeachan-Heo/oh-my-claudecode --skill graph -a claude-code, затем открой ~/.claude/skills/graph/SKILL.md.

Что делает graph?

Запускает пайплайны, описанные JSON-графами с командами, агентами и условиями. Если сбой, граф возобновляется с того же места по журналу — готовые узлы не переделываются.

Как граф отличается от обычного скрипта?

Граф декларативен: ты описываешь зависимости между шагами, а не последовательность; параллелит независимые узлы и переживает сбои. Скрипт — это просто команды подряд.

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

SKILL.md · MIT
---
name: graph
description: Deterministic orchestration graph runtime - declarative DAG pipelines with journal-based crash recovery
argument-hint: "<descriptor.json | describe the pipeline> [--runs-root <dir>]"
aliases: []
level: 4
---

# Graph Skill

Run a deterministic orchestration graph from a declarative JSON descriptor.
The runtime consumes the sealed-descriptor and pure-scheduler contracts in
`src/graph/*` and executes through an independent OS process (`omc graph run`),
so crash recovery (kill mid-run, rerun, resume from journal) works for real.

## Usage

```
/oh-my-claudecode:graph <descriptor.json>
/oh-my-claudecode:graph "build then test then ask me before deploy"   (author the descriptor first)
```

The execution surface is always the CLI subcommand:

    omc graph run <descriptor.json> [--runs-root <dir>]

Run it via the Bash tool for non-interactive graphs. Progress lines stream as
`[run]`, `[node]`, `[ok]`, `[fail]`, `[join]`, `[done]`.

## When To Use

- Repeatable multi-step pipelines with explicit dependencies (DAG)
- Work that must survive interruption: kill/restart resumes from journal
- Auditable runs: OCC journal + projection snapshots under `.omc/graph-runs/<run_id>/`

When NOT to use: exploratory one-off work (use conversation or /team);
anything needing adaptive re-planning mid-run (graphs are deterministic).

## Workflow

1. **Descriptor given** -> go to step 3.
2. **Pipeline described** -> author the descriptor JSON (schema below), write
   it next to the project (suggest `.omc/graphs/<name>.json`) and show it to
   the user before running. `run_id` must be unique per logical pipeline;
   rerunning with the same `run_id` RESUMES, not restarts.
3. **Approval nodes**: if the descriptor contains any `"kind": "human-approval"`
   node, do NOT run it through the Bash tool (stdin is not interactive there;
   EOF fails closed to denied). Tell the user to run interactively instead:

       ! omc graph run <file>

   The `!` prefix runs it inside this session with live stdin so y/n works.
4. Run and relay progress. Exit codes (normative):
   0 succeeded | 1 terminal failed | 19 another writer owns this run (busy)
   20 corrupt/tampered journal (fail-closed) | 21 descriptor drift on resume
   | 70 runtime crash (unmapped error)
5. **Resume**: rerunning the same command after a crash replays committed
   transitions and continues. Completed nodes never re-execute.

## Descriptor Schema (minimal)

{
  "descriptor_version": 1,
  "run_id": "unique-pipeline-id",
  "revision_id": "rev-1",
  "goal": "one line",
  "nodes": [
    { "id": "n1", "kind": "command", "title": "...", "timeout_ms": 60000,
      "max_attempts": 2, "effect_policy": { "policy": "side_effect_free" },
      "command": "npm test" },
    { "id": "a1", "kind": "agent", "title": "...", "timeout_ms": 300000,
      "max_attempts": 1, "effect_policy": { "policy": "side_effect_free" },
      "instructions": "..." },
    { "id": "gate", "kind": "human-approval", "title": "...",
      "prompt": "Proceed?" }
  ],
  "edges": [ { "id": "e1", "kind": "fixed", "from": "n1", "to": "a1" } ],
  "entry_node_ids": ["n1"],
  "concurrency_limit": 2,
  "terminal_verification_node_id": "a1"
}

Edge kinds: fixed | conditional | fan_out/join pairs
| back_edge (bounded retries via max_traversals). See src/graph/schema.ts for
the authoritative Zod schema — and read the Capability Boundary section above
for what built-in executors actually execute today.

## Capability Boundary & Semantics (read before authoring)

- **Edge support**: built-in command/agent executors cover `fixed` edges and
  `fan_out`/`join` pairs. `conditional` and `back_edge` routes are fully
  supported by the runtime and scheduler contracts but require a custom
  NodeExecutor that emits `route` on its results — built-in executors never
  produce routes, so graphs relying on them fail fast with
  `route_required` rather than guessing.
- **Crash-recovery guarantee is at-least-once** for command nodes: a crash
  between an external side effect and its journal append re-executes that node
  on resume. For `idempotent` commands, the resolved key is available to the
  command as `GRAPH_IDEMPOTENCY_KEY` before it starts and is also recorded for
  downstream dedupe. Built-in executors reject `reconcile`; reconciliation
  requires a custom executor with an actual external reconciliation authority.
  Exactly-once for external side effects is out of scope for v1.
- **Command trust boundary**: command nodes are arbitrary shell lines with
  process authority in the current working directory. Only run descriptors
  you wrote or trust. Command children receive an allowlisted environment
  (PATH, HOME/USERPROFILE, TEMP/TMP, locale/timezone, USER identity,
  `GRAPH_*`, and the optional idempotency key), not the host's full secrets.
  Commands are not filesystem/process sandboxed.
- **Agent authority boundary**: built-in agent nodes are explicitly read-only.
  They run in the current working directory with no additional directories,
  only `Read`, `Glob`, and `Grep`, `permissionMode: dontAsk`, session
  persistence disabled, and a provider-specific environment allowlist. Agent
  timeouts abort and interrupt the SDK query. Use a custom executor for any
  agent that needs mutation or external effects. Treat
  `.omc/graph-runs/<run_id>/descriptor.json` as executable content.

© Yeachan-Heo · MIT · Yeachan-Heo/oh-my-claudecode

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — graph от других авторов.

graph smallnest Скилл graph превращает задачу, PRD или набор issues в граф зависимостей (DAG), делит на волны и запускает независимые узлы параллельно — каждый в своём git-worktree, через субагентов. CX Codex +1 267установок graph Artem Novitckii Скилл graph для Claude Code создаёт анимацию линейного графика для рилса: линия растёт, а число меняется вместе с ней. Запускается по /graph или просьбе показать рост либо анимированную статистику. CX Codex +1 ★ 1 047звёзд репо mantis-pipeline-adapter официальный google Скилл mantis-pipeline-adapter для Claude Code, Codex, Cursor и других агентов, который в диалоге помогает спроектировать и написать детерминированный оркестратор поверх Mantis-скиллов. CX Codex +1 1 600установок workflow-builder Alireza Rezvani Плагин workflow-builder проектирует детерминированные многоагентные сценарии на JavaScript для инструмента Workflow в Claude Code. Помогает распределять задачи между субагентами без перегрузки контекста. ★ 30 251звёзд репо maestro-graph ReinaMacCredy Скилл maestro-graph для Claude Code и Codex, который проводит задачу по заранее написанному графу: спускает агентов на каждый узел, собирает их результаты и переходит к следующему шагу. CX Codex +1 ★ 238звёзд репо airflow-expert PCL Team Скилл airflow-expert для Claude Code проектирует и разбирает Apache Airflow DAG, зависимости задач, операторы, сенсоры и расписания. Помогает работать с пайплайнами данных. CX Codex +1 174установок authoring-dags astronomer Скилл authoring-dags помогает создавать и проверять DAG в Apache Airflow по шестиэтапному циклу. Пригодится при написании новых пайплайнов или добавлении задач в существующие графы. CX Codex +1 1 300установок task-decomposer curiositech Скилл task-decomposer разбирает текстовое описание проблемы на подзадачи для узлов DAG, находя зависимости и этапы для параллельного запуска. CX Codex +1 155установок

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

Весь набор →
ultragoal Делит бриф на упорядоченные цели и ведёт дописываемый журнал в .omc/ultragoal, чтобы прогресс пережил перезапуск сессии. CX Codex +1 575установок minimal-code-discipline Скилл minimal-code-discipline применяет YAGNI-дисциплину при написании кода: сначала проверить, есть ли уже готовое, затем стандартная библиотека, и только потом новый код. CX Codex +1 316установок omc-review Скилл omc-review проверяет готовый код на дефекты, риски и избыточность перед выкаткой. Не правит сам — находит и ранжирует проблемы по серьёзности. CX Codex +1 309установок execute Скилл execute для Claude Code ведёт задачу от согласованного плана до кода и проверки. Реализует изменение и подтверждает его работоспособность. CX Codex +1 307установок drydock Скилл drydock для Claude Code разворачивает общую среду разработки в репозитории. При первом запуске создаёт CLAUDE.md и GLOSSARY.md, остальные поверхности — при первом использовании. CX Codex +1 273установок launch Скилл launch для организации полного цикла доставки: от постановки задачи к выпуску проверенного кода. Разделяет работу между агентом (всё, что можно автоматизировать и проверить) и человеком (решения без однозначного ответа). CX Codex +1 272установок tdd Задаёт строгий цикл TDD: агент пишет один падающий тест по согласованному шву, даёт минимальный зелёный код и откладывает рефакторинг на ревью. CX Codex +1 244установок harbor Скилл harbor разбирает входящие issue и PR, проверяет каждое утверждение и отдаёт мейнтейнеру только те решения, которые правда требуют его подписи. CX Codex +1 241установок

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

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