SuperAPI AI 工具集

jupyter-notebook

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:当用户要求创建、搭建或编辑 Jupyter Notebook(.ipynb)时使用,适用于实验与探索性分析,以及教程与教学式讲解两类模式。也可把粗略笔记或脚本转成结构化笔记本,或重构已有笔记本使其更可复现、更易浏览。

主要能力:提供实验模板与教程模板,以及辅助脚本 new_notebook.py,用于加载模板、更新标题单元格并写出笔记本,避免手写原始 notebook JSON。附带参考文档:experiment-patterns.md(实验结构与启发式)、tutorial-patterns.md(教程结构与教学流程)、notebook-structure.md(notebook JSON 结构与安全编辑规则)、quality-checklist.md(最终校验清单)。

使用方式:先设定技能路径,export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}",export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"。用辅助脚本生成笔记本,例如 uv run --python 3.12 python "$JUPYTER_NOTEBOOK_CLI" --kind experiment --title "Compare prompt variants" --out output/jupyter-notebook/compare-prompt-variants.ipynb,教程模式把 --kind 换成 tutorial。随后填充小而可运行的步骤,每个代码单元格聚焦一步,配简短 markdown 说明用途与预期结果。编辑已有笔记本时保留结构、优先定点修改而非整体重写。最后在环境允许时自上而下运行验证。

适用场景:需要他人阅读或重跑的探索性实验、假设驱动分析、分步教学演示。

限制:无必需环境变量;辅助脚本仅用 Python 标准库,无需额外依赖;本地执行笔记本可选安装 uv pip install jupyterlab ipykernel。若无法执行,需明确说明并给出本地验证方法。中间文件放 tmp/jupyter-notebook/,最终产物放 output/jupyter-notebook/。该技能设计为跨 GitHub Copilot、Claude Code 和 Codex 使用,Codex 需同步到 $CODEX_HOME/skills/jupyter-notebook 并重启。无需 MCP 服务器,不得声称使用了当前宿主未提供的 MCP 操作。