メニュー
Guide for understanding and working with the workflow compiler and runtime in src/seer/core/. Use when implementing node executors, debugging compilation/runtime issues, adding workflow features, or understanding the workflow execution architecture.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
use when creating or updating end-to-end tests for the Seer application. This skill provides guidance on how to structure and implement e2e tests effectively.
React Flow best practices for workflow canvas in seer-frontend. Use when modifying WorkflowCanvas, adding new block types, debugging node rendering issues, or optimizing React Flow performance.
Apply Seer design system patterns when creating or modifying UI components. Auto-triggers for badge, button, input, and form components in src/components/.
Use this when you are asked to debug production errors
Guide for adding new external integrations (OAuth or API key-based) to seer. Use when implementing new service integrations like Google, GitHub, Slack, etc.
Context about runtime credential resolution in seer. Use when understanding how OAuth tokens, resources, and secrets are resolved for tool execution.
| name | workflow-compiler |
| description | Guide for understanding and working with the workflow compiler and runtime in src/seer/core/. Use when implementing node executors, debugging compilation/runtime issues, adding workflow features, or understanding the workflow execution architecture. |
| allowed-tools | Read, Grep, Glob, Bash(pytest:*) |
Key principle: src/seer/core/ is pure compilation + runtime — NO database or HTTP. API layer orchestrates compiler + persistence.
WorkflowSpec (JSON) → WorkflowCompiler.compile() (validate → transform → LangGraph) → CompiledGraph → Runtime (node executors + state + checkpointing)
src/seer/core/ → compiler/ (parse · type_env · validate_refs · lower_control_flow · emit_langgraph) · runtime/ (global_compiler · nodes · execution · state · input_validation · validate_output) · schema/ (models · jsonschema_adapter) · expr/ (evaluator · typecheck) · errors.py · registry/ · triggers/
runtime/nodes.py)tool · llm · code · conditional · transform · trigger · input · output · extract · if_else · for_each
State keys: user, node_outputs, workflow_inputs, messages, interrupts. Input resolution: static | input (node output ref) | expression (${node.field}) | workflow_input. Checkpointing: MemorySaver (dev) · DatabaseCheckpointer (prod).
WorkflowCompilerError → ValidationPhaseError (1–3) · TypeEnvironmentError (2) · LoweringError (4) · ExecutionError → EvaluationError (runtime)
schema/models.py, add to Node unionruntime/nodes.pycompiler/compiler.pycompiler/validate_refs.py if neededtests/core/Best practices: No DB/HTTP in compiler · use StrictModel · nodes return partial state updates · always add unit + integration spec tests for src/seer/core/ changes
| File | Purpose |
|---|---|
src/seer/core/runtime/global_compiler.py | WorkflowCompilerSingleton |
src/seer/core/runtime/nodes.py | All node executors |
src/seer/core/schema/models.py | WorkflowSpec, Node, InputDef, OutputContract |
src/seer/core/compiler/validate_refs.py | Reference validation |
src/seer/core/errors.py | Error hierarchy |
src/seer/core/README.md | Architecture overview |
/workflow-validation