update_draft

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

注释已表明这是写操作（readOnlyHint=false）、非幂等且有副作用（openWorldHint=true），描述未与注释矛盾。描述补充了“按位置更新”这一行为语义，但未披露越界 index 时的行为、article 是整体替换还是局部合并、是否存在校验等关键行为特征。在有注释兜底的情况下达到最低可用水平。

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?

单句描述，信息密度高，关键细节（从 0 开始）前置，没有任何冗余词语。虽简短但结构有效，未给 5 分是因为其简洁已接近规格不足的边缘，缺失信息由其他维度扣分体现。

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?

对于带 3 个必填参数且无输出 schema、无参数描述的变更类工具，描述只覆盖了 index 的语义。article 对象的内部结构完全未知，media_id 的作用未说明，越界行为未提及，agent 无法仅凭此描述可靠地构造正确调用。完整性缺口明显。

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%，描述必须承担参数说明的重任，但它只阐明了 index 的 0 起始语义，对最复杂的 article 对象（additionalProperties=true，完全透明）和 media_id 的含义均未提供任何说明。三个必填参数中两个在 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?

描述包含明确的动词（更新）和资源（草稿），并用“按从 0 开始的文章位置”这一关键限定说明了操作方式，能将其与 create_draft、get_draft、delete_draft、list_drafts 等兄弟姐妹工具区分开。虽未显式点名替代工具，但动词+资源的组合已足够清晰，故未给 5 分。

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?

描述的语义暗示了使用场景（在已有草稿的指定文章位置上进行更新），但没有显式说明何时应该选择本工具而不是 create_draft（新建/整体替换）或 get_draft（读取），也没有排除性条件或前置要求。属于隐含用法，缺乏明确路由。

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