Single tool with basic schema and Chinese-language description. Tool name 'read_excel' follows verb_noun convention (+). Input schema present with Zod types and descriptions (+). However, description is in Chinese, limiting LLM comprehension in English-first systems. No output schema documented. Error handling returns text blobs without structured guidance. No parameter constraints (enums, ranges). Missing critical patterns: no pagination support despite potentially large files, no idempotent hints, no security/permission declarations. Tool is read-only but lacks explicit annotation. Overall definition quality is below median for production tools.
读取并理解一个 Excel 或 CSV 文件(包含表名/文件名、表头和前 10 行数据)
No output schema documented. LLMs cannot predict return structure (text content, field names, data types). Breaks downstream tool chaining and forces parsing of unstructured text.
Description in Chinese ('读取并理解一个 Excel 或 CSV 文件...') limits usability in English-first LLM systems. Should provide English description for international adoption.
No pagination or result limits documented. Tool returns 'first 10 rows' hardcoded, but no limit parameter, no next_cursor, no total count. Large files silently truncate without agent awareness.
Error responses are unstructured text ('❌ 未找到文件...', '❌ 仅支持 .xlsx 或 .csv 文件'). No recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No input validation or constraint documentation. 'filePath' accepts any string; no path traversal protection documented. 'sheetName' is optional but behavior when sheet doesn't exist is unclear (silently falls back to first sheet).