asana_reorder_section

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

注释中已提供readOnlyHint=false（暗示是写操作），destructiveHint=false（非破坏性），idempotentHint=true（幂等）。描述未额外说明行为细节，如是否需要在特定权限下执行或是否影响其他数据，但注释已经覆盖了一定信息。描述未与注释矛盾，但也没有补充新行为信息。由于注释已承担部分负担，此处给3分较合理。

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?

描述单句且精准，包含核心信息（动宾结构）、必要参数说明和操作指引（放在before或after），没有冗余内容。但未提及更多细节，不过简单工具所需。虽然短，但不显潦草，信息有效。

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，但重排序通常返回成功状态，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?

输入模式对4个参数的覆盖率是100%，所有参数都已在schema中描述，description没有增加额外语义。但描述提到了before_section或after_section，与schema一致，未提供格式或约束细节。因此根据规则，在覆盖率高的基础上基线为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?

The description clearly states the verb 'Reorder' with the resource 'a section within its project' and adds a concrete analogy 'move a board column'. It specifies the key parameters (before_section or after_section) and what they do. 这与siblings如asana_move_section和asana_update_section区分开来，尽管命名上'Reorder'和'Move'可能相似，但描述里通过括号注释区分了操作类型。

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?

描述指出可以通过before_section或after_section来指定位置，从而提供了明确的用法指示，但未明确说明何时使用reorder而非move_section或update_section，也未说明是否两者互斥或必选其一。没有明确排除条件或提供替代工具的指引，但描述足够清晰，因此得分为中等。

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