# File Reader

> 仅用于读取和总结文本类文件。文本格式优先使用 read_file；需要做类型探测时使用 execute_shell_command。PDF、Office、图片和压缩包由其他技能处理。

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

---

# 文件读取工具箱

当用户要求读取或总结本地文本文件时使用此技能。PDF、Office 文档、图片、音频和视频不在此技能范围内，应由其专用技能/工具处理。

## 快速类型检查

读取前先进行类型探测:

```bash
file -b --mime-type "/path/to/file"
```

如果文件较大，避免输出全部内容；提取小部分相关内容并进行总结。

## 文本文件（使用 read_file）

适用于: `.txt`、`.md`、`.json`、`.yaml/.yml`、`.csv/.tsv`、`.log`、`.sql`、`ini`、`toml`、`py`、`js`、`html`、`xml` 源代码。

步骤:

1. 使用 `read_file` 获取内容。
2. 总结关键部分或展示用户请求的相关片段。
3. 对于 JSON/YAML，列出顶层键和重要字段。
4. 对于 CSV/TSV，展示表头和前几行，然后总结各列。

## 大型日志文件

如果文件很大，使用 tail 窗口:

```bash
tail -n 200 "/path/to/file.log"
```

总结最近的错误/警告和值得注意的模式。

## 超出范围

以下内容不在此技能中处理（由其他技能负责）:

- PDF
- Office (docx/xlsx/pptx)
- 图片
- 音频/视频

## 安全与行为规范

- 绝不执行不可信的文件。
- 优先读取所需的最小部分。
- 如果缺少所需工具，说明限制并请用户提供其他格式。