jupyter-notebook

用途：创建、搭建或编辑 Jupyter Notebook（.ipynb），支持两种主要模式——实验与探索性分析，以及教程与教学演示。优先使用内置模板和辅助脚本，以获得一致结构并减少 JSON 错误。适用场景：从零创建新 .ipynb；把零散笔记或脚本转为结构化 notebook；重构现有 notebook 使其更具可复现性和可浏览性；构建供他人阅读或重跑的实验或教程。决策规则：探索、分析或假设驱动选 experiment；教学、分步或面向特定受众选 tutorial；编辑已有 notebook 视为重构，保留原意并改进结构。技能路径可设置一次：export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"，export JUPYTER_NOTEBOOK_CLI="$CODEX_HOME/skills/jupyter-notebook/scripts/new_notebook.py"；用户级技能安装于 $CODEX_HOME/skills（默认 ~/.codex/skills）。工作流：锁定意图，确定类型并记录目标、受众和完成标准；用辅助脚本从模板搭建，如 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 --title "Intro to embeddings" --out output/jupyter-notebook/intro-to-embeddings.ipynb；填充小而可运行的步骤，每个代码单元聚焦一步，配简短 markdown 说明目的与预期结果，避免冗长输出；按 experiment-patterns.md 或 tutorial-patterns.md 套用相应模式；编辑已有 notebook 时保留结构、优先定向修改，若必须改原始 JSON 先看 notebook-structure.md；最后校验，环境允许时自顶向下运行，不能执行则明确说明并给出本地验证方式，并使用 quality-checklist.md 终检。模板位于 assets/experiment-template.ipynb 与 assets/tutorial-template.ipynb，辅助脚本加载模板、更新标题单元并写出 notebook。临时文件放 tmp/jupyter-notebook/ 并在完成后删除，最终产物放 output/jupyter-notebook/，文件名应稳定且具描述性。依赖按需安装，推荐 uv；本地执行可选 uv pip install jupyterlab ipykernel；辅助脚手架脚本仅用 Python 标准库，无需额外依赖。无必需环境变量。限制：当前资料未提供具体收费、价格、平台与效果信息。