Content
85%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 body is highly actionable with a well-gated, validation-rich workflow and clean one-level-deep references to a real bundle. The main weakness is repetition of several hard rules across multiple sections, which inflates token cost without adding clarity.
Suggestions
Deduplicate rules that appear in multiple sections — e.g. the 'native chart uses <chart>, others use <shape>+<line>' rule and the +replace-slide vs +update-slide choice each appear 3+ times; state each once in 权威经验 or Quick Reference and reference it elsewhere rather than restating.
Consolidate the several 'CRITICAL — ... MUST 先读取 ...' gating lines into a single consolidated preflight checklist to reduce repetition while preserving the must-read signal.
Move long always-inline rule blocks (豆包设计原则) only if a clear always-loaded subset can be extracted; otherwise leave inline but trim overlapping phrasing with the 权威经验 list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is dense and mostly earns its tokens, but several rules are repeated across sections (e.g. native-chart-vs-shape+line appears in 权威经验, Quick Reference, and 核心规则; +replace-slide/+update-slide guidance repeats multiple times), which is more than the 'minor' over-explanation of anchor 4 and fits 'mostly efficient but could be tightened'. | 3 / 5 |
Actionability | Provides fully executable guidance — exact shortcuts and flags ('slides +replace-slide', '--before-slide-id', '--output-dir'), concrete shell examples ('lark-cli wiki +node-get --node-token ...'), and exact XML patterns ('<fill><fillColor color="linear-gradient(135deg, rgba(R,G,B,A) 0%, ...)"/>') — with per-command docs for full params, matching the copy-paste-ready top anchor. | 5 / 5 |
Workflow Clarity | The 生成流程 gives a clear 4-step sequence with explicit validation checkpoints (mandatory `scripts/xml_lint.py` with `error_count` must be 0, post-create `+xml-get` readback per validation-xml.md) and an error-recovery feedback loop ('失败或部分成功按 workflow/error-handling.md 处理；局部问题优先用 +replace-slide 修正'), satisfying the top anchor for this destructive/batch XML manipulation context. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview pointing to a well-organized, one-level-deep bundle (references/workflow/*, references/cli/*, references/xml/*, scripts/*), with all cited paths verified present and clearly signaled via CRITICAL must-read gating and a scenario→doc Quick Reference table, matching the clear-overview top anchor. | 5 / 5 |
Total | 18 / 20 Passed |