SuperAPI AI 工具集

vignette-catalog-compose-notebook

数据与分析

查看项目

更新于 10-15 17:31

技能介绍

该技能面向已存在的 vignette catalog(由 catalog.toml 与自包含的 marimo 笔记本组成,笔记本兼具示例与可导入辅助模块)。使用时先解析技能目录,并直接执行其 Python 脚本以应用 uv shebang。核心脚本为 <skill-dir>/scripts/catalog-session.py,负责会话生命周期:启动、复用、检视、运行、停止。不要用 nohup 或后台方式自行启动 marimo,也不要手工从 pgrep、ss、curl 或 /api/sessions 重建会话状态;若辅助脚本失败,应先原样报告其输出。

按请求分流:打开、运行或查看指定笔记本,或让 catalog 跑起来,走快速路径;在已激活的笔记本中改输入,复用其会话;组合新笔记本或回答数据问题,走 compose 流程。快速路径:读 AGENTS.md 与 catalog.toml,确认认证要求与 [getting_started].first_notebook,然后运行 <skill-dir>/scripts/catalog-session.py open [--host <address>] [notebooks/<name>.py]。报告 url=、session= 与 cells= 原文;cell_error= 表示有失败单元格。可用 status --cells 查看状态、run <port> 重跑、stop <port> 停止。

compose 流程依赖 marimo-notebook 与 marimo-pair 两个项目技能,缺失时应给出仓库文档中的安装命令而非隐式安装。用 catalog-session.py open notebooks/<name>.py 打开目标笔记本,通过实时内核用 marimo-pair 的 code 模式编辑并运行单元格,最后用 bash <skill-dir>/scripts/validate-notebook.sh notebooks/<name>.py 在干净状态下验证。该脚本会运行 marimo 检查、Ruff、冷执行与失败单元格扫描,默认恢复源码与快照,仅在 catalog 策略要求时加 --write。整体验证 catalog 时,应枚举实际笔记本文件而非假定 catalog.toml 完备。限制:资料未提供具体的认证方式、示例数据源与笔记本内容细节。