Run a read-only pre-flight health check before collection or domain farming to validate install, window/resolution readiness, route assets, Pathing files, and configs, catching missing items early.
开跑前体检（只读，不启动任何进程）：安装与关键配置、进程/窗口就绪（可见+前台+16:9≥1080P）、显示分辨率与 DPI 能否容纳 1920×1080、安装包识别资源分辨率、路线资产、配置组里每个 Pathing 项目对应的文件是否真的存在（缺失会被静默跳过）、一条龙配置与收工动作、MCP/包装器等闭环件。跑采集或秘境前先调它。
| Name | Required | Description | Default |
|---|---|---|---|
| material | No | 可选：额外检查某材料的路线是否已装（例：星螺） |
Changes observed during successful MCP inspections.
v1.0.0Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
在没有注解的情况下，这句描述通过声明该工具只读、不会启动任何进程，承担了大部分职责——这正是 agent 在担心卡住游戏或触发运行时所需要知道的。它还披露了一个不明显的安全细节：缺失的 Pathing 条目会被静默跳过，这正是要事先检查的原因。缺的是它预期运行多久，以及它报告的结果是什么形态。
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 的只读诊断工具来说，描述已经足够完整：它说明了何时调用、是否安全、覆盖哪些内容，以及哪些检查结果会被静默忽略。唯一真正的遗漏是没有描述它返回的判定结果，而 agent 会希望知道这一点，以便据此分支处理。
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?
唯一一个可选参数（material）在 schema 中已有完整说明（100% 覆盖率），因此 baseline 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?
开头就断言一个具体动作——开跑前体检，并立即限定范围（只读、不启动任何进程），随后逐一列出检查覆盖的内容（安装、窗口就绪、DPI、路径资产、配置组中的 Pathing 文件、一条龙配置、MCP 封装）。一个 agent 不必打开其他工具就能知道 bgi_doctor 与 bgi_status 或 bgi_run_* 在操作特性上的区别。
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?
"跑采集或秘境前先调它" 明确给出了调用时机，而且非常可操作。但它没有说明何时可以安全跳过，也没有点名替代工具（例如 bgi_status），因此实际使用时 agent 必须自行推断边界情况。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.