用途：把刚克隆的目录仓库（jx、fgx、prx、dmx 或任何基于 catalog-skills 模式的目录）带入可运行的 marimo 内核，然后交接给后续编排流程。
主要步骤：先读仓库根目录的 catalog.toml，获取 first_notebook、auth（所需环境变量）和目录名；若没有该文件，则回退到 notebooks/ 中编号最小的笔记本并查看 README.md 的鉴权说明。确认 uv 已安装（uv --version），缺失时安装：curl -LsSf https://astral.sh/uv/install.sh | sh；再为智能体安装 marimo-pair 技能：npx skills add marimo-team/marimo-pair --agent claude-code -y。若清单声明了鉴权环境变量（如 FINNGENIE_TOKEN），需确认 .env 存在且变量已设置，否则停止并告知用户如何获取令牌，不得继续。
启动方式：在沙箱中后台启动首个笔记本并记录端口，例如分配随机端口后执行 env -u PYTHONPATH uvx marimo edit --sandbox --no-token --port $PORT notebooks/<first_notebook>。--sandbox 为必需项以准备 PEP 723 依赖；env -u PYTHONPATH 用于规避 Nix-shell websockets 垫片导致的启动崩溃。
是否使用 --headless 取决于编排方：人类配对且有浏览器时省略，marimo 会自动打开浏览器并注册内核会话；由智能体驱动或无浏览器（远程/SSH、CI）时传入 --headless 并自行注册会话，否则服务器无会话，首次调用会报 No active sessions on the server。无浏览器时可先让用户打开 http://localhost:$PORT（macOS 用 open，Linux 用 xdg-open），完全无头时运行脚本 scripts/register-session.py --port $PORT 获取会话 ID，并可用 curl -s http://127.0.0.1:$PORT/api/sessions 确认会话已列出。最好通过已安装的 marimo-pair 脚本 scripts/execute-code.sh 显式运行所有单元，并抽查关键变量是否已解析，避免内核为空这一常见问题。最后告知用户内核运行端口及可开始提问，由 compose-notebook 技能接手。
限制：公共目录（jx、prx、dmx）无需鉴权，fgx 需要 FINNGENIE_TOKEN。不要自创替代启动命令或自建无头会话引导。若仓库 gitignore 了技能存储、只跟踪 skills-lock.json 且技能缺失或过期，可用 npx skills update 从锁文件重建，但那是技能已存在后的刷新，不是克隆时引导；克隆后恢复应放在仓库跟踪的 AGENTS.md / README.md 中。