下架商品

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

标注已声明 destructiveHint=true，描述进一步澄清破坏范围：只会从销售渠道撤下，不会删除商品，并补充“调用前应获得用户确认”的操作要求。这超越了标注本身提供的信息，且与标注不矛盾。

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 的简单工具，描述配合已有标注和 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%，但描述中“商品”和“指定销售渠道”能为 id 和 publicationIds 提供基本语义映射。不过描述未明确说明 id 是 Product GID、publicationIds 是 Publication GID 列表，也未解释约束条件，因此只部分弥补了 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?

描述使用明确动词“撤下”和资源“商品/销售渠道”，清楚说明该工具从指定渠道下架商品而非删除商品。虽未点名对比兄弟工具，但“不会删除商品”与 publish_product/set_product_status 等在语义上有区分。

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?

描述隐含了使用场景：当需要从特定销售渠道撤下商品时使用，并通过“不会删除商品”排除了删除用途。但未明确说明与 shopify_publish_product、shopify_set_product_status 的选型关系，也未给出何时不应使用本工具。

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