Content
82%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.
A dense, executable reference: complete CLI contracts, full schemas, state machines, and check-first workflows with dedup checkpoints. The only real gaps are undocumented query-output formats and the absence of post-write verification loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean operational reference — schema tables, state-machine diagrams, CLI signatures, and usage rules — with no concept explanations Claude already knows and no padded sections; every section carries information needed to operate the tool (e.g., the application-status bullets genuinely disambiguate 'passed' vs 'rejected'). | 5 / 5 |
Actionability | Every command is a complete executable CLI signature with argument enums and required fields marked ("必填:--name、--type、--firm"), and check-* commands document their JSON output shape. Minor gap: output formats for query-progress/query-stale/query-applications are undocumented, unlike the check commands. | 4 / 5 |
Workflow Clarity | The 使用规则 section sequences both workflows clearly with an explicit pre-write checkpoint ("先用 check-investor 判断是否已记录,已在数据库中则跳过") and idempotent init, plus stale-query sweeps as recurring checkpoints. It stops short of the top anchor because there is no post-write verification or error-recovery loop, which matters for database operations. | 4 / 5 |
Progressive Disclosure | Well-organized single-file reference with clear sections (location, schema, commands, rules); the bundle is deliberately abstracted behind the PATH wrapper with an explicit instruction not to hand-assemble script paths, and the one external reference (expert-ir 包内 scheduling.md) is clearly signaled and one level deep. Minor gap: the 200-line schema/CLI reference could arguably live in a separate reference file, and the cross-package reference depends on material outside this bundle. | 4 / 5 |
Total | 17 / 20 Passed |