SuperAPI AI 工具集

jupyter-notebook

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:处理 .ipynb 笔记本的全流程,包括从零创建、检查单元格/输出/元数据/依赖与执行状态、增删改与重排代码和 Markdown 单元格、执行并刷新输出、排查内核故障、制作表格与图表等可视化,以及把零散笔记或脚本整理为结构化笔记本、重构既有笔记本使其更可复现。适合需要被他人阅读或重跑的探索性实验与教学式教程。

主要能力与模式:按请求类型二选一——探索性、分析性、假设驱动选 experiment;教学性、分步、面向特定受众选 tutorial;编辑既有笔记本视为重构,保留原意并改进结构。

使用方式:先锁定意图,明确类型、目标、受众与完成标准;再用辅助脚本从模板脚手架生成,避免手写原始 JSON: python3 "<SKILL_BASE_DIR>/scripts/new_notebook.py" --kind experiment --title "Compare prompt variants" --out "compare-prompt-variants.ipynb" python3 "<SKILL_BASE_DIR>/scripts/new_notebook.py" --kind tutorial --title "Intro to embeddings" --out "intro-to-embeddings.ipynb" 模板位于 assets/experiment-template.ipynb 与 assets/tutorial-template.ipynb。填写时保持每个代码单元格专注一步,配简短 Markdown 说明目的与预期结果,避免冗长噪声输出;实验与教程分别遵循 references/experiment-patterns.md 和 references/tutorial-patterns.md。编辑既有笔记本优先定向修改,避免整体重写,除非能改善自上而下的叙事顺序,必要时须遵循 references/manual-editing.md。

工具选择:操作前先检查是否有可用的 Jupyter MCP 工具,优先使用已连接的 Jupyter MCP 服务器;若不可用或操作失败,应明确告知用户改用手动编辑,且同一改动不得同时使用 MCP 与手动 JSON 编辑。

验证与依赖:环境允许时自顶向下运行整个笔记本,不能执行时须明确说明并给出本地验证方法,最后按 references/quality-checklist.md 检查。可选安装本地执行依赖:python3 -m pip install jupyterlab ipykernel;脚手架脚本仅用 Python 标准库,无需额外依赖。无必需环境变量。中间文件使用系统临时目录并在完成后删除,成品保存到用户指定位置,未指定则存当前项目目录,文件名稳定且具描述性(如 ablation-temperature.ipynb)。其他具体平台与收费标准暂未提供。