ruyi_clear_site_data

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

无注解，描述需承担行为透明度责任。它清楚列出了清除的具体内容（Cookie、localStorage、sessionStorage）和范围（当前页面），提供了基本且有用的行为信息。但未说明清除操作不可逆、是否触发页面刷新等额外效果。

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?

对于简单清除工具，描述基本够用，但缺少对pageIdx参数的解释，也未说明清除后是否影响iframe或需要刷新页面。在无注解和输出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?

唯一参数pageIdx在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?

描述使用明确动词'清除'和资源'当前页面的浏览器状态'，并列出了Cookie、localStorage、sessionStorage，清晰说明了工具功能。与仅删除Cookie的ruyi_delete_cookies等兄弟工具区分明显。

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?

描述隐含了使用场景（清除当前页面的所有浏览器状态），但未明确何时使用本工具而非替代方案（如ruyi_delete_cookies只清理Cookie）。没有提及排除情况或前置条件。

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