Content
86%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 lean, highly actionable body: every migration pattern is shown as executable Before/After code, and the workflow ends in an explicit type-check validation step. The only gaps are a trimmable rationale section and a missing fix-and-revalidate loop after the type check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — terse Before/After pairs, a compact decision table ("何时使用哪一个"), and a one-line install command. Minor over-explanation could be trimmed (e.g., "经过训练,不去使用它" and the long first Before example with 20 fake properties), fitting anchor 4 rather than 5. | 4 / 5 |
Actionability | Fully executable guidance: "npm i @total-typescript/shoehorn", a ready-to-run grep ("grep -r \" as [A-Z]\" --include=*.test.ts --include=*.spec.ts"), three copy-paste Before/After code patterns (fromPartial, fromAny, large-object case), and a table covering which function to use. This matches anchor 5 — specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The "工作流" section gives a clear sequenced checklist (install → grep for `as` → replace patterns → add imports → "运行 type check 验证") with an explicit validation step. It falls short of anchor 5 because there is no error-recovery loop (what to do when the type check fails), fitting anchor 4 (minor validation gaps). | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed: this single-purpose skill (~120 lines) is appropriately self-contained with well-organized, clearly headed sections (为什么用, 安装, 迁移模式, 何时使用哪一个, 工作流) that are easy to navigate — matching the simple-skill case for anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |