CSV 数据摘要 技能
使用本地 Python 图表检查 CSV 结构、缺失值和数值摘要。
社区 · coffeefuelbump| 作者 | coffeefuelbump |
|---|---|
| 许可证 | MIT (README declaration; no LICENSE file) |
| 来源 | coffeefuelbump/csv-data-summarizer-claude-skill · GitHub 上的 SKILL.md |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
csv-data-summarizer 指导用 Python 检查 CSV 行、类型、缺失值、分布和相关性。内置 analyze.py 生成文本报告及适用的 PNG 图表。
脚本按列名猜测日期候选,并使用 pandas 默认设置。领域解释、标识符和日期聚合需要核对;相关性不是因果证据。
摘自该技能的 SKILL.md: CSV Data Summarizer
功能
- 读取 CSV,检查类型和缺失单元格。
- 汇总数值字段和选中的分类字段。
- 生成相关图表,只解释数据支持的模式。
产出内容
- 文本摘要,以及适用的分布、相关性和时间序列 PNG 图表。
- analyze.py 在当前工作目录写出的文件。
适用场景
- 初步了解不熟悉的 CSV。
- 在深入分析前寻找缺失数据和候选趋势。
不适用的场景
- 把自动类型/日期推断当作已验证领域分析,或把敏感 CSV 交给未经审阅的宿主。
所需条件
- 按上游声明,需要 Python 3.8 以上、pandas 2+、matplotlib 3.7+ 和 seaborn 0.12+。
- 本地文件访问及合适的工作目录;宿主助手访问数据时遵循其自身隐私条款。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 分析流程与报告指引。 |
analyze.py | CSV 摘要和 PNG 图表生成。 |
requirements.txt | 声明的 Python 包依赖。 |
resources/sample.csv | 示例数据集,不是其他数据集的证据。 |
2026-11-18 在仓库中查到的许可证:MIT (README declaration; no LICENSE file)。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 检查此 CSV,选择图表前先报告缺失单元格。
- 解释 analyze.py 把哪些列当作日期或类别,并标记可能的误判。
- 在新输出文件夹中运行已审阅的本地分析,避免覆盖已有 PNG。
如何安装 csv-data-summarizer
Python 环境与输出文件夹
审阅 analyze.py 后,在隔离环境中安装声明的依赖。技能文件夹不包含 Python 或这些库。
PNG 文件名固定,并写入当前工作目录。请使用专用输出文件夹。README 声明 MIT,但没有独立 LICENSE 文件。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/coffeefuelbump/csv-data-summarizer-claude-skill.git
mkdir -p ~/.claude/skills/csv-data-summarizer
git -C csv-data-summarizer-claude-skill archive HEAD | tar -x -C ~/.claude/skills/csv-data-summarizerClaude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /csv-data-summarizer,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/coffeefuelbump/csv-data-summarizer-claude-skill.git
mkdir -p .agents/skills/csv-data-summarizer
git -C csv-data-summarizer-claude-skill archive HEAD | tar -x -C .agents/skills/csv-data-summarizer| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
检查自动报告
缺失值与类型摘要是有用的初步证据。没有缺失单元格不代表现实数据完整或准确。
稀疏日期、常量列、数字 ID 和高基数类别都可能产生无意义图表。请检查实际 PNG 和报告,不要只相信完成提示。
关于 csv-data-summarizer 的常见问题
需要上传到图表服务吗?
脚本本身读取本地 CSV 并写入本地 PNG;宿主 AI 助手仍可能按自己的条款接收数据。
如何识别日期?
脚本选择列名包含 date 或 time 的字段,再尝试 pandas 转换。这个启发式规则需要检查。
数字 ID 会影响相关性吗?
会。数字列会进入数值摘要和相关性计算,应检查标识符列,而非默认这些关系有意义。
能处理所有 CSV 编码和分隔符吗?
不一定。内置脚本使用 pandas read_csv 默认设置,不提供全部解析选项;特殊文件需要适配并验证。
更多 AI 技能
相关技能
D3 可视化 技能
社区 · chrisvoncsefalvay使用明确的比例尺、响应式尺寸和清理机制,构建定制 D3 图表与交互。Dashmotion 技能
社区 · Mars (csthink)生成带结构检查的独立 HTML 动画流程图和架构图。内容研究写作 技能
社区 · ComposioHQ在保留作者声音的同时,研究、拟纲并修改有来源支撑的文章。Matplotlib 技能
社区 · K-Dense使用明确坐标轴创建科学绘图。AI信息图 技能
社区 · K-Dense通过OpenRouter生成及审查栅格信息图。Markdown Mermaid写作 技能
社区 · Clayton Young / K-Dense使用符合版本的Mermaid结构图编写Markdown。