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

在注解已声明写操作、开放世界、非幂等且非破坏性的基础上，额外披露了需要登录且为主办方、缺省 confirmed=false 不上公开页、仅在对方明确同意并同意展示时才传 true、每场最多 30 位、本工具不通知任何人、头像由嘉宾自助上传等关键行为。这些信息远超注解覆盖，且与注解无冲突。

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，描述完整覆盖调用前提（登录/主办方）、在业务链中的位置、参数默认值与限制、容量上限（30 位）、通知行为及头像处理方式。对于一个无输出 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 提供。描述额外补充了‘每场最多 30 位’等约束，但对具体参数的语义说明基本重复 schema（如 confirmed 缺省值、userId 用途），未在参数层面提供实质性增量信息，符合 100% 覆盖率下的基线 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?

明确说明具体动作：将某人录入活动嘉宾阵容，站内用户挂 userId，并指出这是邀请嘉宾的第一步。通过组合链和‘本工具不通知任何人’与 create_guest_invite_link、send_guest_invite_now 等兄弟工具区分开。

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?

给出完整的工具编排链：search_people 核对身份 → 本工具 → create_guest_invite_link → start_conversation/send_message 发送并确认。同时说明 confirmed 参数的使用条件，明确何时传 true。虽然未列出‘何时不用’，但链式上下文和替代步骤已经足够明确。

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