菜单
Set up Cursor for a Continuum project — .cursor/rules/ MDC file, glob patterns, and what to include so Cursor generates correct Continuum code. Invoke when the user asks "set up Cursor for my project", "Cursor rules for Continuum", ".cursor/rules", or "MDC file for Continuum".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Get a Continuum agent up and running — Python 3.13 venv, infra via `continuum up`, smallest possible BaseAgent + AgentRunner example. Invoke when the user asks "how do I start", "set up Continuum", "run my first agent", or is at the very beginning of a project.
Set up Claude Code for a Continuum project — CLAUDE.md wiring, skill imports, project settings, and hooks. Invoke when the user asks "set up Claude Code for my project", "CLAUDE.md for Continuum", "add skills to my project", or "configure Claude Code hooks".
Set up OpenAI Codex CLI for a Continuum project — AGENTS.md content, project conventions, and what Codex needs to write correct Continuum code. Invoke when the user asks "set up Codex for my project", "AGENTS.md for Continuum", or "configure Codex CLI".
Build BaseAgent instances and run them with AgentRunner — covers fields, lifecycle hooks, structured outputs, ReAct mode, instruction modifiers, and the full execution flow. Invoke when the user asks "create an agent", "configure max_turns", "add lifecycle hooks", "structured output with Pydantic", or anything around the core agent abstraction.
Pick the right LLM provider, configure structured outputs, control context-window compression, and use the LLMClient directly. Provider routing is by model-string prefix; LiteLLM has been removed. Also covers Smart Gateway integration for multi-provider routing. Invoke when the user asks about "switch to Claude", "Gemini structured output", "context length error", "rate limiting", "JSON schema", "Smart Gateway", "gateway_mode", or "how does the LLM client work".
Configure and use Continuum's two-tier memory system — mem0+Qdrant/Milvus for long-term facts, Redis for short-term sessions, with multi-tenant scopes (USER / AGENT / SHARED / RUN / CONVERSATION). Invoke when the user asks about "remember", "user preferences", "long-term memory", "vector search over memories", "multi-tenant isolation", "PII filtering on memory writes", "Milvus", "Qdrant", or memory-related errors.
| name | continuum-cursor |
| description | Set up Cursor for a Continuum project — .cursor/rules/ MDC file, glob patterns, and what to include so Cursor generates correct Continuum code. Invoke when the user asks "set up Cursor for my project", "Cursor rules for Continuum", ".cursor/rules", or "MDC file for Continuum". |
Cursor reads .cursor/rules/*.mdc files. The Continuum repo ships
.cursor/rules/continuum.mdc — copy it into any downstream project.
Create .cursor/rules/continuum.mdc:
---
description: Continuum agent framework conventions for this project
globs: ["src/**/*.py", "tests/**/*.py", "playground/**/*.py"]
alwaysApply: true
---
# Continuum Project Rules
This project uses **Continuum** (import: `orchestrator`, package: `shyftlabs-continuum`).
## Setup invariants
- Python 3.13. Venv: `python3.13 -m venv .venv`
- All public APIs are **async**. Entrypoints: `asyncio.run(main())`
- Always `load_dotenv()` before importing orchestrator settings
- `OPENAI_API_KEY` required even when using Anthropic/Gemini (mem0 embedder)
- Infra via docker compose: Redis :6380, Milvus :19530 (or Qdrant :6333)
## Core imports
\`\`\`python
from orchestrator.agent import BaseAgent, AgentRunner
from orchestrator.agent.config import AgentConfig, AgentMemoryConfig, RunnerConfig
from orchestrator.agent.types import Handoff, MemoryScope, RunContext, EventType
from orchestrator.llm import LLMClient, LLMConfig
from orchestrator.memory import MemoryClient
from orchestrator.session import SessionClient
\`\`\`
## Provider routing
Model string prefix determines provider (when gateway is not set):
- `gpt-*`, `openai/*` → OpenAI SDK
- `claude-*`, `anthropic/*` → Anthropic SDK
- `gemini/*`, `google/*` → Gemini via OpenAI-compat
When `SMART_GATEWAY_URL` is set, all models route through GatewayProvider automatically.
Use `gateway_mode="strict"|"modest"|"quality"` on BaseAgent to control routing tier.
## Critical don'ts
- No `litellm` — removed entirely
- No `response_format` on Anthropic — instruct via system prompt and parse manually
- No JSON mode + tools on Gemini simultaneously — pick one
- MemoryScope enum: `from orchestrator.agent.types import MemoryScope` (not from `orchestrator.memory`)
- SessionClient.add_message takes `ChatMessage(...)` not `role=` kwargs
Match these globs to ensure rules apply to all relevant files:
globs:
- "src/**/*.py" # application source
- "tests/**/*.py" # tests
- "playground/**/*.py" # playground scripts
- "*.py" # root-level scripts
Use alwaysApply: true for framework-level rules that apply regardless
of which file is open.
Split into focused files for large projects:
.cursor/rules/
├── continuum.mdc # framework API — alwaysApply: true
├── agents.mdc # project-specific agent descriptions
├── testing.mdc # test conventions — globs: tests/**
└── api.mdc # FastAPI/endpoint conventions
AGENTS.md or docs instead.alwaysApply: true for files with large content — it inflates every request's context.