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.
A compact, dispatch-style overview: the body routes read/write intents through tight tables with concrete commands and a destructive-write confirmation, deferring detail to three real reference files. Main deductions are a dangling routes/svg-edit.md link, version-pinned commands inline, and no explicit post-write validation loop in the body itself.
Suggestions
Fix or create the referenced `routes/svg-edit.md` — the body's write-path table links to it but the file does not exist in the bundle.
Move the pinned version `@larksuite/whiteboard-cli@^0.2.13` into the reference file or a dedicated version/prerequisites note so the body stays version-agnostic.
Add an explicit post-update verification step (e.g., re-export a preview after `+update`) to close the feedback loop for destructive/batch write operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean decision tables with essentially no padding — every row is actionable — but it embeds time-sensitive version info ("npx -y @larksuite/whiteboard-cli@^0.2.13") and a duplicated prerequisite pointer without a deprecated/versions section, so it sits just below the lean anchor. | 4 / 5 |
Actionability | Gives concrete, executable guidance: exact commands (`lark-cli --version`, `+export --output-type preview/svg/source`), identity flags (`--as user`), and an explicit match-and-stop dispatch rule. Minor gap: full command syntaxes are deferred to reference files, so the body alone is not copy-paste ready. | 4 / 5 |
Workflow Clarity | Clear two-stage decision procedure ("先判断「只读还是写入」,再在对应表内按上到下匹配,命中即停") with a destructive-operation checkpoint ("写入非空已有画板并需要 overwrite 时,先确认会整板重建"). Post-write verification/validation of results is not stated in the body, keeping it below the explicit-feedback-loop anchor. | 4 / 5 |
Progressive Disclosure | Three real, well-signaled one-level-deep reference files (references/lark-whiteboard-export.md, -update.md, -workflow.md) are linked from both decision tables and a Shortcuts table, and details are properly split out. However, the body links to `routes/svg-edit.md` which does not exist in the bundle (no routes/ directory), a dangling navigation path. | 4 / 5 |
Total | 16 / 20 Passed |