weibo-post-search

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

没有任何 annotations，描述承担了全部行为披露责任，但它只说“查询列表”，没有说明返回内容、分页行为、是否需要登录/授权、是否有频率限制或副作用。对于一个只读查询工具，这虽然是轻量操作，但信息仍然不足。

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 覆盖完整，但缺少输出说明、分页细节、适用场景和兄弟工具区分。对 agent 来说，这能满足最低调用需求，但在没有 annotations 的情况下仍不够完整。

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 对 userId 和 page 都有说明，覆盖率为 100%，schema 已经承担了主要参数语义。描述本身没有在 schema 之外补充参数格式、取值范围或 userId 的获取方式，因此按高覆盖率基线给 3 分。

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?

描述明确指出了操作对象“微博用户作品”和动作“列表查询”，agent 能理解这是按用户获取作品列表的工具。虽然未显式与同平台的其他微博工具对比，但“用户作品列表”已经足够将其与 weibo-comment-search、weibo-hot-search 等区分开。

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?

描述没有说明何时使用该工具、何时应使用替代工具，也没有排除性条件。只能从“用户作品列表”暗示其用途，缺少与 weibo-search、weibo-comment-search 等兄弟工具的明确使用边界。

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