用途:Viz 技能直接执行可视化。调用方提供可视化规格和数据上下文,技能会推断数据加载代码、生成完整绘图脚本并通过 viz_runner.py 执行,最后返回产物路径供调用方引用。
主要能力:支持两种模式。检查模式使用 --show 打印 DataFrame 的形状、列、类型和前若干行(--rows 指定行数),不生成图表;可视化模式生成 matplotlib/seaborn 代码并经 stdin 传入执行。支持 marimo 笔记本:用 --marimo、--notebook、--target-var 指定目标变量,技能复制笔记本到 /tmp/viz/、分析依赖、裁剪单元格、注入绘图代码后执行,原笔记本只读不改;变量在单元格内被多次修改时可用 --target-line 捕获中间状态。
使用方式:通过 python /Users/rob/.claude/skills/viz/viz_runner.py [--id NAME] [--desc "说明"] 加 heredoc 脚本执行。脚本从 /tmp/viz/ 运行,所有文件路径必须使用绝对路径,相对路径会失败。runner 会确保 ID 唯一、注入 savefig 到 /tmp/viz/<id>.png(dpi=150)、写脚本与 JSON 元数据。用 --list 列出已有可视化,--clean 清理 /tmp/viz/。重新生成可直接运行保存的 .py 脚本,无需 runner。发布质量建议:轴标签含单位、标题清晰、figsize=(10,6)、tight_layout()、alpha=0.3 网格、色盲友好调色板。默认不要自动把 PNG 读入上下文,可提示用 open 打开。
适用场景:从 DuckDB、SQL、parquet、CSV 或 marimo 笔记本数据绘制柱状、折线、散点、分布、热力图等;快速检查数据结构;对比同一图表多个版本。
限制:未提供支持的 Python 版本、依赖安装方式和收费信息。文件路径须绝对;笔记本绘图脚本以原目录为工作目录运行;README 中给出的路径为示例环境路径,实际以本机安装位置为准。