---
name: csv-free-tool
slug: csv-free-tool
displayName: "CSV"
version: "1.0.0"
summary: "解析生成RFC 4180合规CSV,跨工具通用"
description: "解析生成RFC 4180合规CSV,跨工具通用。Parse and generate RFC 4180 compliant CSV that works across tools。触发关键词: generate, compliant, parse, csv, works。提供专业能力支持,覆盖多场景工作流,支持自动化处理。"
license: "MIT"
tools:
  - read
---

# CSV

## Quoting Rules

* Fields containing comma, quote, or newline MUST be wrapped in double quotes
* Double quotes inside quoted fields escape as `""` (two quotes), not backslash
* Unquoted fields with leading/trailing spaces—some parsers trim, some don't; quote to preserve
* Empty field `,,` vs empty string `,"",`—semantically different; be explicit

## Delimiters

* CSV isn't always comma—detect `;` (European Excel), `\t` (TSV), `|` in legacy systems
* Excel exports use system locale delimiter; semicolon common in non-US regions
* Sniff delimiter from first line but verify—header might not contain special chars

## Encoding

* UTF-8 BOM (`0xEF 0xBB 0xBF`) breaks naive parsers but Excel needs it for UTF-8 detection
* When generating for Excel on Windows: add BOM; for programmatic use: omit BOM
* Latin-1 vs UTF-8 ambiguity—explicitly declare or detect encoding before parsing

## Common Parsing Failures

* Newlines inside quoted fields are valid—don't split on `\n` before parsing
* Unescaped quote in middle of field corrupts rest of file—validate early
* Trailing newline at EOF—some parsers create empty last row; strip or handle
* Inconsistent column count per row—validate all rows match header count

## Numbers & Dates

* `1,234.56` vs `1.234,56`—locale-dependent; standardize or document format
* Dates: ISO 8601 (`2024-01-15`) only unambiguous format; `01/02/24` is chaos
* Leading zeros in numeric fields (`007`)—quote to preserve or document as string

## Excel Quirks

* Formula injection: fields starting with `=`, `+`, `-`, `@` execute as formulas—prefix with `'` or tab
* Long numbers (>15 digits) lose precision—quote and format as text
* Scientific notation triggered by `E` in numbers—quote if literal text needed

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent( Code / Cursor / Codex /  CLI等)
- **操作系统**: Windows / macOS / Linux

### 依赖说明
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
- 本Skill基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)

### 可用性分类
- **分类**: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行任务

## 核心能力

- Parse and generate RFC 4180 compliant CSV that works across tools
- 触发关键词: generate, compliant, parse, csv, works

## 适用场景

| 场景 | 输入 | 输出 |
|------|------|------|
| 基础使用 | 用户请求 | 处理结果 |

**不适用于**：需要人工判断的复杂决策场景

## 使用流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

## 示例

### 示例1：基础用法

```
输入: 用户请求
处理: 根据使用流程执行
输出: 处理结果
```

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 检查网络连接后重试，参考国内替代方案 |

## 常见问题

### Q1: 如何开始使用CSV？
A: 请先阅读使用流程章节，确认环境满足依赖说明中的要求。

### Q2: 遇到错误怎么办？
A: 请参考错误处理章节，按照表格中的处理方式操作。

### Q3: CSV有什么限制？
A: 请参考已知限制章节了解具体限制。

## 已知限制

- 需要API Key，无Key环境无法使用

---
## 边界条件与限制

### 输入限制
- **数据格式**: 输入数据必须符合RFC 4180标准，否则技能可能无法正确解析。
- **数据大小**: 输入数据的大小受限于Agent平台的内存和性能，过大的数据可能会导致性能问题或解析失败。
- **字段数量**: 单个CSV文件中的字段数量不应超过Agent平台的限制，否则可能导致错误。

### 性能边界
- **处理速度**: CSV技能的解析和生成速度取决于数据的大小和复杂性，以及Agent平台的性能。
- **并发处理**: CSV技能通常不支持高并发处理，大量并发请求可能会导致性能下降。

### 兼容性约束
- **操作系统**: CSV技能在Windows、macOS和Linux操作系统上均应正常工作，但特定功能可能因操作系统差异而有所不同。
- **Agent平台**: CSV技能需要支持SKILL.md的AI Agent，如 Code、Cursor、Codex、 CLI等。
- **编码格式**: 输入数据的编码格式应与技能期望的编码格式一致，通常为UTF-8。

### 其他限制
- **公式处理**: CSV技能无法处理包含公式的字段，如Excel中的公式字段。
- **日期格式**: CSV技能只能处理符合ISO 8601标准的日期格式。
- **空值处理**: CSV技能对空值的处理可能因解析器而异，建议在输入时明确指定空值表示方式。

---