Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a tight, well-structured environment manual: every section conveys facts Claude could not infer (ID conventions, eta semantics, category taxonomy, tool parameters) and the examples are concrete ask_env calls with outputs. It misses top marks only on small margins — repeated constraint statements, a missing find_nearby_pois example, and no explicit end-to-end workflow with error handling.
Suggestions
Add a worked find_nearby_pois example that shows obtaining x, y from get_person's position, and briefly explain what the "<observe>" instruction should contain.
State the implicit workflow explicitly (observe → choose destination via search/recommendation → move_to → wait for idle) with a note on recovering from an interrupted move.
Deduplicate the ask_env-only rule and the moving-interruption warning, each of which currently appears twice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and environment-specific throughout (ID ranges like "ID 从 500000000 开始", the eta rule "行程用时以 move_to 返回的 eta 为准", category tables Claude could not know), with nothing explaining general knowledge; the only trimmable fat is repetition — "所有操作必须通过 ask_env" appears in the intro, the 可用工具 section, and 约束 1, and the moving-interruption warning appears in both 移动状态 and 约束 2 — which keeps it at 'minor instances that could be trimmed' rather than a 5. | 4 / 5 |
Actionability | The examples are concrete and executable (e.g. `ask_env(instruction="Move person 0 to AOI 500000123 using driving", ctx={"id": 0})` with expected outputs), and every tool's parameters are enumerated; minor gaps remain — find_nearby_pois gets no worked example and no guidance on sourcing x, y from get_person's position, and the "<observe>" placeholder is never explained — so it is 'mostly executable with minor gaps' rather than copy-paste-complete across common cases. | 4 / 5 |
Workflow Clarity | The examples form a natural progression (observe status → go to work → search and travel → return home) and an arrival checkpoint is stated ("到达后自动恢复为 idle") along with the explicit interruption rule; it falls short of a 5 because no end-to-end sequence is spelled out and there is no error-recovery guidance (e.g. what to do after an interrupted move or when no POI is found). | 4 / 5 |
Progressive Disclosure | The single-file structure is well organized into 环境概念 / 可用工具 / 示例 / 约束 with no bundle files to reference; the one organizational question is the 14-row POI category table, which is borderline reference material that could live in a separate file — a minor placement gap that fits 'good structure, minor organization gaps' rather than the ideal split-and-navigate pattern of a 5. | 4 / 5 |
Total | 16 / 20 Passed |