desirecore_status

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

注释已经声明了 readOnlyHint=true、openWorldHint=true、idempotentHint=true 和 destructiveHint=false，提供了较强的安全特性基线。描述在此基础上增加了关键行为信息：无参数时会刷新实例列表，而带参数时会检查实际 CDP 连接，并且该检查不证明隧道已连通。这些信息超越了注释范围，提供了重要的行为上下文。没有描述副作用（例如刷新实例列表是否会有持久性影响），但考虑到这些注释，这个级别的透明度是合适的。

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，因此未描述返回值，但该工具的核心用途已经清楚。一个小的缺口是未说明该工具的预期用例（例如在调试时验证 CDP 连接），但考虑到这个简单的工具和已提供的上下文，这个缺口并不严重。

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 中描述（它必须是来自 desirecore_list_instances 的有效 instanceId，格式为 32 位十六进制）。描述进一步说明了该参数的作用：决定是检查整个服务还是特定实例，并补充了关键细节：实例重启后必须重新列举并选择，且不接受端口或路径。这超出了 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?

描述明确说明了核心功能：检查独立 MCP 服务的状态（不传 instanceId 时）或检查特定实例的 CDP 连接状态（传入时）。动词'检查'与资源'独立 MCP 服务'和'CDP 连接'相结合，并明确区分了两种模式。它还明确指出该工具不证明隧道已接通，这有助于避免歧义。与同级的 desirecore_list_instances（列出实例）和 desirecore_cdp（建立/使用 CDP 连接）等工具有明显区别。

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?

描述说明了两种不同场景的使用条件（有无 instanceId），并明确指出该工具不验证隧道连通性，这暗示了何时不应依赖该工具（例如验证隧道时）。虽然没有明确提及替代工具，但参数描述指出 instanceId 必须来自 desirecore_list_instances，从而隐含了与列表工具的关系。对于使用场景的清晰描述来说，这已足够，但缺乏显式的'何时不使用'的说明。

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