功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

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

核心理念

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

依赖说明

运行环境

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

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

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. 逗号分隔

默认使用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分号、系统区域分隔符检测。

错误处理

错误场景	原因	处理方式
字段含逗号未引号	违反RFC 4180引号规则	用双引号包裹含逗号/引号/换行的字段
内部引号未转义	单引号而非 ""	引号字段内部的双引号转义为两个双引号
列数不一致	某些行多/少字段	校验所有行匹配表头列数，报错或补齐
空字段语义混淆	,, 与 ,"", 混用	显式区分空字段与空字符串字段
Excel中文乱码	缺UTF-8 BOM	免费版不提供BOM处理；付费版提供
欧洲Excel分隔错误	用逗号而非分号	免费版仅支持逗号；付费版支持分号
长数字精度丢失	Excel 15位限制	免费版不提供引号保留；付费版提供
公式注入风险	字段以 =+-@ 开头	免费版不提供防御；付费版提供 ' 前缀

常见问题

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文件的破解。
• 依赖目标工具的解析行为，跨工具兼容性需实际验证。

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

差异化对比

对比维度	本技能	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	核心功能	通用场景	通用场景

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果