paper_search

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

披露了两源合并去重的行为特性，并详细说明了返回JSON的结构（包含title, authors, journal等字段）。由于无注解，描述承担了完整的行为说明责任，但未提及错误处理、认证需求或速率限制。

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?

采用标准docstring结构，分行为说明（双源搜索）、参数(Args)和返回值(Returns)三部分，中文表述简洁，每句都提供有价值信息，无冗余。

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描述覆盖率0%，描述已相当完整：涵盖两个参数语义、双源去重行为、返回JSON结构。但因未提及错误处理情形、速率限制或与兄弟工具的明确区分，略有不足。

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?

输入Schema描述覆盖率为0%，但描述通过Args部分完美补偿：详细说明query参数接受关键词或DOI并提供具体示例（'gradient magnetic field coil'或'10.1109/tim...'），rows参数说明为返回结果数量且默认值为8。

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?

描述明确说明'搜索论文'并使用Crossref + Semantic Scholar双源合并去重，提供了具体动词和资源。但并未明确区分与paper_recommend等兄弟工具的差异。

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?

说明了支持关键词搜索或DOI查询两种模式（支持...或...），但未提供何时使用此工具而非paper_recommend或paper_citation_graph的指导，也未说明使用限制或前置条件。

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