list_screener_metrics

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

描述披露了无 keyword 时返回内容约为带 keyword 时的 9 倍，提示性能影响。但没有提及返回结构、分页或数据量上限。无注释信息，描述承担部分行为披露责任，但本工具为只读元数据列表，风险较低。没有与注释矛盾。

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?

描述简洁，先说明用途和调用时机，再用建议强调 keyword 的重要性，最后列出参数含义。没有冗余信息，但参数部分重复了 schema 中的字段名（可接受）。结构合理，重点前置。

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（未展示但存在），描述解释了工具用途、参数含义和使用建议。对于列出元数据的工具，已足够让代理正确调用。缺少对返回格式的显式说明，但输出 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?

schema 描述覆盖率为 0%，但描述对两个参数给出了明确含义：market 指定市场（CN/HK/US），keyword 用于按中文名或指标名过滤。描述补充了 schema 未提供的信息，但未说明 market 的枚举或默认值的具体行为，虽有默认值但未描述。覆盖了关键语义，略有不足。

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?

明确说明该工具列出选股器支持的指标及其中文名（雪球官方元数据），并提及在 screen_stocks 前调用以确认指标名。动词+资源+具体内容都清晰，与兄弟工具区分度高（screen_stocks 执行筛选，此工具提供元数据）。

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?

明确说明应在 screen_stocks 前调用，且建议总是带 keyword 以避免返回大量数据。虽未明确提及何时不用，但上下文已提供足够的使用时机。与兄弟工具的关系通过引用 screen_stocks 暗示。

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