ai_create_document

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

无注解提供，描述必须承担行为披露。描述仅声明“新建文档”和单位，但未说明是否覆盖现有文档、是否自动打开新画板、是否需要设置名称或是否要求宽高为正数等行为细节。对于创建操作，这些信息缺失。

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?

描述仅两句，第一句说明目的，第二句明确单位和参数含义，非常简洁。但第二句略显冗余，因为 schema 已有参数描述，不过并未造成冗长，结构合理。

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?

工具复杂度低（2个参数、无输出 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 描述覆盖 100%，两个参数都有中文说明。描述仅补充“单位为点”，但未增加超出 schema 的含义（如默认值、范围或约束）。基线为 3，描述没有额外价值，因此保持 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?

描述明确说明“在 Illustrator 中新建一个文档”，动词“新建”加资源“文档”，单位也明确。与 ps_create_document 等兄弟工具区分明显，因为前缀 ai_ 表明是 Illustrator 的操作。

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?

描述提到了单位（点）和尺寸参数，但未说明何时使用此工具而非其他创建工具（如 ps_create_document），也未提供负面条件或替代方案。仅有隐含的使用场景，缺乏明确的 when/when-not 指导。

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