CSV解析生成-免费版

CSV — 解析与生成（免费版）

输入格式

核心理念

产出RFC 4180合规的CSV，确保含特殊字符的字段正确转义。免费版覆盖基础引号规则与逗号分隔.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY=${API_KEY:?请设置环境变量}

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

核心理念(补充)

输入: 用户提供核心理念相关的配置参数、输入数据和处理选项.

• 参考核心理念的配置文档进行参数调优

核心能力（免费版）

• 参考核心能力（免费版）的配置文档进行参数调优

1. 基础引号规则

• 含逗号、引号或换行的字段必须用双引号包裹
• 引号字段内部的双引号转义为 ""（两个引号），而非反斜杠
• 空字段 ,, 与空字符串 ,"", 语义不同；要显式

2. 逗号分隔

默认使用RFC 4180标准的逗号分隔。每行一条记录，字段间以逗号分隔.

• 参考逗号分隔的配置文档进行参数调优

3. 列数校验

校验所有行匹配表头列数，尽早发现列数不一致问题. 输入: 用户提供核心能力（免费版）相关的配置参数、输入数据和处理选项.

• 参考列数校验的配置文档进行参数调优

付费版专享能力

升级付费版解锁以下高级能力：

• 多分隔符识别：分号（欧洲Excel）、\t（TSV）、|（遗留系统）.
• 编码与BOM处理：UTF-8 BOM（0xEF 0xBB 0xBF）、Latin-1 vs UTF-8、Excel Windows需BOM.
• 解析失败排查：引号内换行、未转义引号、EOF尾换行、列数不一致详细诊断.
• 数字与日期格式：

输入: 用户提供付费版专享能力相关的配置参数、输入数据和处理选项.

快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

核心能力（免费版）(补充)

1. 基础引号规则(补充)

• 含逗号、引号或换行的字段必须用双引号包裹
• 引号字段内部的双引号转义为 ""（两个引号），而非反斜杠
• 空字段 ,, 与空字符串 ,"", 语义不同；要显式

2. 逗号分隔(补充)

默认使用RFC 4180标准的逗号分隔。每行一条记录，字段间以逗号分隔.

3. 列数校验(补充)

使用流程

1. 识别目标工具：确认CSV的消费方（默认假设支持逗号分隔）.
2. 应用引号规则：含逗号/引号/换行的字段双引号包裹；内部引号转义为 "".
3. 区分空字段：明确使用 ,,（空）与 ,"",（空字符串）的语义.
4. 校验列数一致：所有行匹配表头列数.
5. 跨工具验证：在目标工具中打开验证渲染正确. 结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

示例

示例1：含逗号与引号的字段

输入数据：姓名="张,三", 备注="他说""你好"""
RFC 4180输出：
"张,三","他说""你好"""

示例2：空字段区分

输入：空字段 vs 空字符串字段
,,    → 空字段（null语义）
,"",  → 空字符串字段（""语义）
两者不同，需显式区分

示例3：列数校验

表头：name,age,email
行1：张三,30,zhang@example.com     → 3列 ✓
行2：李四,25                       → 2列 ✗ 列数不一致

付费版专享能力(补充)

• 数字与日期格式：1,234.56 vs 1.234,56本地化、ISO 8601、前导零保留.
• Excel特性防御：公式注入（=+-@）、15位精度丢失、科学计数法 E.
• 前导/尾随空格处理：未引号字段的空格裁剪差异处理.
• 跨区域设置适配：欧洲Excel分号、系统区域分隔符检测.

错误处理

常见问题

Q1：免费版支持哪些分隔符？

免费版仅支持逗号分隔（RFC 4180默认）。分号、\t、| 等为付费版专享.

Q2：字段内有双引号怎么处理？

用双引号包裹整个字段，内部的双引号转义为两个双引号 ""。例如 他说"你好" 应写作 "他说""你好""".

Q3：Excel打开CSV中文乱码怎么办？

免费版不提供BOM处理。付费版提供UTF-8 BOM（0xEF 0xBB 0xBF）能力，为Windows Excel加BOM.

Q4：如何防止Excel公式注入？

免费版不提供公式注入防御。付费版提供 ' 前缀防御 =+-@ 开头字段.

Q5：长数字为什么在Excel里变了？

Excel对数字仅保留15位精度。免费版不提供引号保留能力；付费版提供引号包裹并格式化为文本.

Q6：如何升级到付费版？

参考 csv 付费版SKILL.md，解锁多分隔符、编码BOM、解析失败排查、数字日期格式、Excel特性防御等能力.

已知限制

• 仅支持逗号分隔，不支持分号/\t/|（付费版专享）.
• 不提供UTF-8 BOM处理（付费版专享）.
• 不提供解析失败详细排查（付费版专享）.
• 不提供数字与日期格式指导（付费版专享）.
• 不提供Excel特性防御（公式注入、精度丢失、科学计数法）（付费版专享）.
• 不支持加密CSV文件的破解.
• 依赖目标工具的解析行为，跨工具兼容性需实际验证.