用途:当用户要求创建、搭建或编辑 Jupyter Notebook(.ipynb)时使用,覆盖实验与探索性分析、教程与教学式讲解两种主要模式,也支持把粗略笔记或脚本整理成结构化笔记本,或重构已有笔记本使其更可复现、更易浏览。
主要能力:提供 experiment 与 tutorial 两类内置模板(assets/experiment-template.ipynb、assets/tutorial-template.ipynb),以及辅助脚本 new_notebook.py,用于加载模板、更新标题单元格并写出笔记本,避免手写原始 notebook JSON 出错。附带参考文档:experiment-patterns.md、tutorial-patterns.md、notebook-structure.md、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/。资料未提供收费、价格或平台支持信息。