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 token-efficient, highly actionable command reference with explicit safety guidance for write operations. It is well organized for navigation, with only minor redundancy and no external bundle structure to evaluate.
Suggestions
Remove the one-line 简介 (it duplicates the frontmatter description) and merge 完整服务列表 into the 常用服务速查 section or move it to a referenced file to reduce overlap.
Add a short numbered '写操作流程' checklist (confirm region/resource IDs → run dry query → execute → verify result) to turn the 安全注意事项 guidance into an explicit validate-then-act sequence.
If per-service detail grows, split each service table into a references/ file (e.g. references/cvm.md) linked from the overview to exercise progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean command tables with minimal prose and no padding of concepts Claude already knows, but the 简介 line repeats the frontmatter description and 完整服务列表 partially overlaps the 常用服务速查 tables, offering minor trim opportunities. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready tccli commands throughout the service tables plus concrete worked examples (filter, output formats, batch query) covering the common cases. | 5 / 5 |
Workflow Clarity | A clear install → configure → use ordering is present and the 安全注意事项 section provides explicit validation for destructive/write operations (confirm account, region, resource ID, intent), so the destructive-cap is avoided; however it is not a numbered checkpoint sequence with validate→fix→retry loops. | 4 / 5 |
Progressive Disclosure | A single well-sectioned file with clear headers and one-level external doc links (官方文档, GitHub); inlining is appropriate for a quick-reference manual, but no bundle files are used to split the per-service detail, so it does not demonstrate the full split-and-reference pattern. | 4 / 5 |
Total | 17 / 20 Passed |