$npx -y skills add agentscope-ai/QwenPaw --skill file_reader-zh仅用于读取和总结文本类文件。文本格式优先使用 read_file;需要做类型探测时使用 execute_shell_command。PDF、Office、图片和压缩包由其他技能处理。
| 1 | # 文件读取工具箱 |
| 2 | |
| 3 | 当用户要求读取或总结本地文本文件时使用此技能。PDF、Office 文档、图片、音频和视频不在此技能范围内,应由其专用技能/工具处理。 |
| 4 | |
| 5 | ## 快速类型检查 |
| 6 | |
| 7 | 读取前先进行类型探测: |
| 8 | |
| 9 | ```bash |
| 10 | file -b --mime-type "/path/to/file" |
| 11 | ``` |
| 12 | |
| 13 | 如果文件较大,避免输出全部内容;提取小部分相关内容并进行总结。 |
| 14 | |
| 15 | ## 文本文件(使用 read_file) |
| 16 | |
| 17 | 适用于: `.txt`、`.md`、`.json`、`.yaml/.yml`、`.csv/.tsv`、`.log`、`.sql`、`ini`、`toml`、`py`、`js`、`html`、`xml` 源代码。 |
| 18 | |
| 19 | 步骤: |
| 20 | |
| 21 | 1. 使用 `read_file` 获取内容。 |
| 22 | 2. 总结关键部分或展示用户请求的相关片段。 |
| 23 | 3. 对于 JSON/YAML,列出顶层键和重要字段。 |
| 24 | 4. 对于 CSV/TSV,展示表头和前几行,然后总结各列。 |
| 25 | |
| 26 | ## 大型日志文件 |
| 27 | |
| 28 | 如果文件很大,使用 tail 窗口: |
| 29 | |
| 30 | ```bash |
| 31 | tail -n 200 "/path/to/file.log" |
| 32 | ``` |
| 33 | |
| 34 | 总结最近的错误/警告和值得注意的模式。 |
| 35 | |
| 36 | ## 超出范围 |
| 37 | |
| 38 | 以下内容不在此技能中处理(由其他技能负责): |
| 39 | |
| 40 | |
| 41 | - Office (docx/xlsx/pptx) |
| 42 | - 图片 |
| 43 | - 音频/视频 |
| 44 | |
| 45 | ## 安全与行为规范 |
| 46 | |
| 47 | - 绝不执行不可信的文件。 |
| 48 | - 优先读取所需的最小部分。 |
| 49 | - 如果缺少所需工具,说明限制并请用户提供其他格式。 |