Skip to content
FunCoding

file_reader

读取与摘要文本类文件(txt、md、json、yaml、csv、log、代码文件等)。PDF 与 Office 文件由专用技能处理。

Star
1,157
License
Apache-2.0
Last commit
Oct 13, 2026

mateclaw-server/src/main/resources/skills/file_reader/SKILL.md

View on GitHub

文件读取

当用户要求读取或摘要本地文本文件时使用本技能。

不在范围内:PDF、Word (.docx)、Excel (.xlsx)、PPT (.pptx)、图片、音视频 — 这些由专用技能处理。

工作流程

第一步:类型探测(可选)

不确定文件类型时,先探测:

macOS / Linux:

execute_shell_command(command="file -b --mime-type \"/path/to/file\"")

Windows:

execute_shell_command(command="cmd /c \"echo %~x1\" & exit", timeoutSeconds=10)

或直接根据扩展名判断。

第二步:读取文件

read_file(filePath="/absolute/or/relative/path/to/file.txt")

读取特定行范围(大文件时):

read_file(filePath="/path/to/large.log", startLine=1, endLine=200)

第三步:处理内容

根据文件类型采用对应策略:

类型处理方式
.txt / .md直接摘要或按用户需求处理
.json / .yaml先列出顶层键,再展开用户关注的字段
.csv / .tsv展示表头 + 前 5 行,再描述各列含义和数据规模
.log读取最后 200 行,聚焦错误/警告模式
源代码说明文件作用,摘要核心逻辑,不逐行复述

大文件策略

文件超过 500 行时分段读取:

# 先读前 100 行了解结构
read_file(filePath="/path/to/big.log", startLine=1, endLine=100)

# 再读末尾 200 行看最新内容
read_file(filePath="/path/to/big.log", startLine=-200)

日志文件也可用系统命令读取末尾:

macOS / Linux:

execute_shell_command(command="tail -n 200 \"/path/to/file.log\"")

Windows:

execute_shell_command(command="powershell Get-Content -Tail 200 \"/path/to/file.log\"")

跨平台路径注意事项

  • Windows:路径使用反斜杠 \ 或正斜杠 / 均可,但含空格时须加引号
  • macOS / Linux:使用正斜杠 /,含空格时须加引号或转义

安全规范

  • 只读取文件,不执行其内容
  • 优先读取所需的最小部分,避免加载超大文件到上下文
  • 如文件包含敏感信息(密码、密钥),提醒用户注意但不拒绝读取

Similar Skills

Featured

pdf

Read and edit PDFs: extract text and tables, merge, split, rotate, and fill forms.

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

canvas-design

Create posters and visual art as PNG or PDF, guided by a design philosophy.

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

docx

Create and edit Word docs with TOC, page numbers, headers and more.

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

doc-coauthoring

Co-write specs, proposals and decision docs through a structured, iterative workflow.

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

xlsx

Read and edit spreadsheets: add columns, compute formulas, format, and clean messy data.

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

pptx

Create and edit slide decks, generate slides from templates, and extract text.

ANanthropics/skills181k1,119 new stars in the last 7 days