wechat_automator

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

注解均为中性false值，未提供安全画像，描述需要承担完整的副作用披露责任。描述补充了返回JSON结构，但未说明tap/input/set_data等操作可能产生的状态变更、是否需要先执行start，或是否存在权限/运行环境要求，透明性不足。

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?

该工具包含13种action和多个依赖参数，动作间存在耦合关系（如start需要project_path，tap需要selector），而描述只是动作清单，没有阐述各动作的使用场景、先决条件或副作用。即使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?

顶层params参数在schema中无描述，覆盖率为0%；描述没有对params结构或任何属性进行补充说明，仅用括号标注了action的中文含义，无法补偿参数语义空白。描述没有帮助代理理解如何为不同的action组合正确的参数。

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?

描述以具体动词短语'小程序自动化交互与运行时查询'明确工具功能，并列出13种支持的动作及返回格式，使代理能识别这是用于微信小程序自动化交互与运行时查询的工具。但未明确与兄弟工具进行对比，因此不足以达到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?

描述仅列举了支持的动作，没有说明何时应使用该工具而不使用兄弟工具（如 wechat_inspector、wechat_screenshot），也没有提到使用条件或动作之间的先后顺序，缺少任何关于如何选择本工具的指导。

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