Skill: lqiuee/operation (version 1.0.1)

--- name: excel-analysis-operation description: Excel/CSV 文件数据分析与操作技能，提供全面的数据分析、列对比、数据清洗和洞察报告功能。当用户需要分析 Excel 数据、对比不同列、清洗数据或生成详细报告时触发此技能。 --- # Excel 数据分析与操作工具箱 ## 概述 Excel Analysis Operation 是一个强大的 Excel/CSV 文件分析与操作技能，提供以下核心功能： 1. **全面数据分析** - 自动分析数据质量、统计信息、数据分布和业务洞察 2. **列对比功能** - 对比任意两列数据，找出差异、共同值和唯一值 3. **数据清洗工具** - 自动清理空列、重复数据，处理缺失值 4. **智能报告生成** - 生成包含多个工作表的详细 Excel 报告 ## 快速开始 ### 主要脚本 - `scripts/excel_operations.py` - 主脚本，包含所有功能 - `scripts/analyze_data.py` - 详细数据分析脚本 - `scripts/compare_columns.py` - 列对比脚本 ### 基本用法 ```bash # 数据分析 python scripts/excel_operations.py analyze data.xlsx # 列对比 python scripts/excel_operations.py compare data.xlsx "姓名" "Email" # 数据清洗 python scripts/excel_operations.py clean data.csv ``` ## 核心功能详解 ### 1. 数据分析 (analyze) **功能**：全面分析 Excel/CSV 文件，生成详细报告 **使用方式**： ```bash python scripts/excel_operations.py analyze 数据文件 [--focus 列名] [--output 输出文件] ``` **参数说明**： - `数据文件`：Excel (.xlsx/.xls) 或 CSV 文件路径 - `--focus`：可选，指定要分析的列（逗号分隔） - `--output`：可选，指定输出文件路径 **输出报告包含**： - 数据概览（行数、列数、文件大小等） - 列信息（数据类型、空值统计、唯一值等） - 数值列统计（最小值、最大值、平均值、标准差等） - 分类列分析（唯一值数量、值分布等） - 业务洞察（数据质量问题、异常值等） ### 2. 列对比 (compare) **功能**：对比任意两列数据，找出差异 **使用方式**： ```bash python scripts/excel_operations.py compare 数据文件 列A 列B [--mode 模式] [--output 输出文件] ``` **列引用方式**： - 列名：`"姓名"`、`"Email"`、`"订单编号"` - 列字母：`A`、`B`、`C`、`AA` - 列索引：`0`、`1`、`2`（从0开始） **对比模式**： - `full`（默认）：完整对比，显示所有结果 - `diff`：仅显示差异值 - `unique_a`：仅显示 A 列独有的值 - `unique_b`：仅显示 B 列独有的值 - `common`：仅显示两列共有的值 **输出包含**： - 对比汇总（各列唯一值数量、共有值等） - 仅在 A 列的值 - 仅在 B 列的值 - 共有的值 ### 3. 数据清洗 (clean) **功能**：自动清理数据，提高数据质量 **使用方式**： ```bash python scripts/excel_operations.py clean 数据文件 [--output 输出文件] [--no-dedup] [--fill 填充方式] ``` **清洗功能**： - 删除完全为空的列 - 删除重复行（默认启用，可用 `--no-dedup` 禁用） - 处理缺失值： - `none`（默认）：不填充 - `zero`：数值列填充为 0 - `mean`：数值列填充为平均值 - `mode`：分类列填充为最高频值 - 清理字符串列的前后空格 ## 使用示例 ### 示例 1：分析销售数据 ```bash python scripts/excel_operations.py analyze sales_data.xlsx --focus "订单金额,商品数量,客户类型" ``` **预期输出**： - 分析报告：`sales_data_analysis_report.xlsx` - 包含：数据概览、数值统计、分类分析、业务洞察 ### 示例 2：对比客户名单 ```bash python scripts/excel_operations.py compare customers.xlsx "姓名" "邮箱" --mode diff ``` **预期输出**： - 对比报告：`customers_对比_姓名_vs_邮箱.xlsx` - 显示：仅在姓名列的值、仅在邮箱列的值 ### 示例 3：清洗用户数据 ```bash python scripts/excel_operations.py clean user_data.csv --fill mean --output cleaned_data.xlsx ``` **预期输出**： - 清洗后数据：`cleaned_data.xlsx` - 清洗报告：显示删除的空列、重复行、填充的缺失值 ## 高级功能 ### 智能编码检测 脚本自动检测文件编码（支持 UTF-8、GBK、GB2312、Latin1 等），无需手动指定编码。 ### 列名智能解析 支持多种列引用方式： ```bash # 使用列名 python scripts/excel_operations.py compare data.xlsx "姓名" "Email" # 使用列字母 python scripts/excel_operations.py compare data.xlsx A B # 使用列索引 python scripts/excel_operations.py compare data.xlsx 0 1 ``` ### 彩色输出 控制台输出使用彩色编码： - ✅ 绿色：成功信息 - ⚠️ 黄色：警告信息 - ✗ 红色：错误信息 - ℹ️ 蓝色：普通信息 ### 异常值自动检测 数据分析功能自动检测数值列的异常值（使用 IQR 方法），并生成警告。 ## 实际应用场景 ### 场景 1：市场调研数据分析 **需求**：分析客户调研问卷数据 ```bash python scripts/excel_operations.py analyze survey_data.xlsx --focus "年龄,收入,满意度,购买意向" ``` ### 场景 2：库存数据对比 **需求**：对比两个时间点的库存数据 ```bash python scripts/excel_operations.py compare inventory.xlsx "当前库存" "上周库存" --mode diff ``` ### 场景 3：CRM 数据清洗 **需求**：清洗客户关系管理系统导出的数据 ```bash python scripts/excel_operations.py clean crm_export.csv --fill mode --output cleaned_crm.xlsx ``` ## 脚本结构 ``` scripts/ ├── excel_operations.py # 主脚本，包含所有功能 ├── analyze_data.py # 详细数据分析脚本 └── compare_columns.py # 列对比脚本 ``` ### excel_operations.py 功能模块 - `analyze_data()`: 综合分析功能 - `compare_columns()`: 列对比功能 - `clean_data()`: 数据清洗功能 - `read_file_with_encoding()`: 智能文件读取 - `resolve_column()`: 列引用解析 ## 输出文件说明 ### 数据分析报告 - `数据概览`：基本信息汇总 - `列信息`：每列的详细统计 - `数值统计`：数值列的统计摘要 - `分类统计`：分类列的分析 - `业务洞察`：数据质量问题和建议 ### 列对比报告 - `汇总`：对比结果摘要 - `仅A列`：仅在 A 列的值 - `仅B列`：仅在 B 列的值 - `共有值`：两列共有的值 ## 故障排除 ### 常见问题 1. **编码问题**：如果遇到编码错误，脚本会自动尝试多种编码 2. **列找不到**：确保列名正确，或使用列字母/索引 3. **内存不足**：对于超大文件，建议分批处理 ### 环境要求 - Python 3.6+ - pandas >= 1.0.0 - openpyxl >= 3.0.0 - numpy >= 1.18.0 ### 安装依赖 ```bash pip install pandas openpyxl numpy ``` ## 最佳实践 1. **备份原始数据**：在进行数据清洗前备份原始文件 2. **逐步分析**：先分析整体数据质量，再进行针对性操作 3. **验证结果**：对比清洗前后的数据差异 4. **记录操作**：保存分析报告和清洗记录 ## 触发关键词 当用户提到以下关键词时，此技能会自动触发： - "分析 Excel 数据" - "对比两列数据" - "数据清洗" - "Excel 数据分析" - "生成数据报告" - "找出数据差异" - "清理重复数据" - "处理缺失值" - "数据质量分析" - "Excel 操作" --- 此技能提供了完整的 Excel/CSV 文件分析与操作解决方案，适用于数据分析师、业务人员、开发人员等需要处理表格数据的各种场景。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)