用途:把目标仓库搭建成面向单一数据集的 vignette 目录。目录以 manifest 加一个可用 notebook 起步,不是包或流水线。仅在无法推断时才询问目录名、目标路径和数据表面(rest、duckdb、pooch 或 files)。
主要能力:检查目标,新目录要求空或不存在,已有仓库需保留文件并使用 --adopt;询问一次可选约定(标准数据布局与工作协议、带索引 notebook 的输出摘要、提交会话快照),说明后等待回答再应用。生成最小结构,脚本命令保持原样: <skill-dir>/scripts/scaffold.py <target> --name <name> --surface <surface> 已有仓库追加 --adopt。脚本复制真实资产,不靠模型从文字复现模板。将 notebooks/nb01_orientation.py 中刻意的 NotImplementedError 替换为一次访问真实数据集的有限调用,可复用访问逻辑放入顶层 @app.function,依赖与版本写在 notebook 的 PEP 723 块。填写 catalog.toml 中数据集相关字段,如 description、上游版本、缓存、注意事项、认证、helper 名称及 orientation notebook 展示内容;数据集标识、API 行为、哈希与运维注意事项保留在此目录而非共享技能中。采用时协调而非覆盖 README.md、AGENTS.md、.gitignore、pyproject.toml;生成的 AGENTS.md 包含克隆后技能安装命令,并在数据集契约中记录采用与拒绝的约定及路径、快照策略。
若选择标准布局:输入放 data/raw/、data/external/,共享中间产物放 data/interim/,各分析工作区放 data/processed/<analysis>/;数据从 raw/external 流向 interim 再到 processed,分析也可直读输入。禁止手改输入或共享中间产物,应改准备 notebook 或 helper 并重新生成。共享须保留他人输出与本地工作,设立本身不授权上传或替换共享数据。
若选择输出摘要与索引:每个有保存输出的分析写 summary.json,含 description、numbers(名称/值对象)、files(仓库相对路径与说明);标准布局放 data/processed/<analysis>/summary.json。创建 notebooks/index.py 发现并展示这些信封,需容忍空集合;若输出被忽略,应允许列出信封及父目录;输出文件不可用时不报错。
若选择会话快照:跟踪 notebooks/marimo/ 中的 marimo 快照,验证时用 --write 刷新;否则保持忽略。
最后使用文档记录的命令安装项目技能,通过 vignette-catalog-compose-notebook 打开 orientation notebook,检查真实输出并运行 scripts/validate-notebook.sh。复用现有目录 helper 与 notebook 进行检索和准备;仅当项目需要时再增加 src/、共享环境、工作流引擎或云同步。限制:未提供具体版本、安装命令细节、计费或平台信息。