ingest_docx

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

无注释，描述承担全责。描述了转换流程、输出文件结构、旧版格式支持，且说明了通过 LibreOffice 转换，这提供了一些行为信息。但未涉及副作用、权限需求、失败情况或是否可逆，对于摄取工具通常安全，但描述未明确声明破坏性状态，因此部分透明。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

描述结构清晰，有分节（转换流程、支持元素、输出目录），开头总结了功能，后面详述细节。虽然较长，但每条信息对工具使用均有帮助，没有冗余。较复杂工具需要详细说明，因此适当，但可精简。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

工具复杂度较高（解析、转换、输出多文件），描述覆盖了主要方面：支持格式、转换中间表示、输出目录结构、支持复杂元素，并存在输出 schema 说明返回值。但缺少错误处理、性能考虑、权限需求及与兄弟工具的边缘情况，整体较完整但仍有提升空间。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

只有一个参数 file_path，schema 无描述（覆盖率为0%），但描述中 Args 部分明确说明 'file_path: .docx 或 .doc 檔案的絕對路徑'，提供了参数的类型（绝对路径）和格式要求，这远超 schema 提供的信息，因此充分补偿了低覆盖率。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

描述明确说明工具作用：摄取 .docx/.doc 文件并转换为 DFM 格式，动词明确（攝入/轉換），资源明确（文件）且输出清晰，包含详细输出目录结构。与兄弟工具如 convert_document、save_docx 有明确区分，因为它聚焦于摄取并转换为特定文档格式。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述隐含使用场景（处理 docx/doc 文件），但未明确说明何时使用此工具而不是其他兄弟工具（如 convert_document、save_docx）。没有提供排除条件或替代方案，但由于描述了详细输出结构，用户能推断用途，但缺少显式指南。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.