# File Operations

> 读写文件、管理工作区文件。

- Skill: `tencent/file-operations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tencent/file-operations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencent/file-operations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tencent (https://skillmd.com/u/tencent)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tencent/file-operations

---


# 文件操作

用于在工作区内读取、写入和检查文件的工具集。

## 工具

- `read_file` — 按路径读取文件内容。
- `write_file` — 写入或覆盖文件。
- `list_directory` — 列出目录内容。
- `file_exists` — 检查文件或目录是否存在。

## 示例

读取文件：
```
read_file(path="src/main.py")
```

写入文件：
```
write_file(path="output/report.md", content="# 报告\n\n内容...")
```

列出目录内容：
```
list_directory(path="src/")
```

读取前先检查是否存在：
```
file_exists(path="config.yaml")
```

## 提示

- **始终使用相对路径**，基于工作区根目录。
- **先检查再读取**：对不确定是否存在的文件，先用 `file_exists` 检查。
- **不要读取二进制文件**（图片、PDF 等），它们无法以文本形式呈现。
- **写入时务必确认路径**，避免误覆盖重要文件。