Content
53%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 delivers a genuinely executable pipeline — deterministic ranking script, explicit workspace protocol, and a concrete deliverable template — supported by a real, well-externalized bundle. Its weaknesses are repetition (workspace rules stated four times, generic boilerplate constraints), a structurally broken code fence around the report template, and a validation step that names no concrete check.
Suggestions
State the .bensz-api workspace convention once and reference it from the constraints; delete the duplicated '文件隔离' and '公共硬约束' restatements, keeping only skill-specific constraints.
Make the 校验 step concrete: name the actual command, e.g. `python3 skills/nsfc-code/scripts/validate_skill.py ...`, and specify the pass criteria the deliverable must meet (5 recommendations, all codes exist as section keys in the TOML).
Fix the broken code fence around the report template (lines 100-117) so the deliverable template is unambiguous, and either reference or remove the unused references/demo/ and scripts/validate_skill.py bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The workspace/path convention (".bensz-api/task-{ts}...") is stated at least four times — in the timestamp section (lines 40-46), the "输出管理" section inside the output template (line 134), the "文件隔离" constraint (line 153), and "公共硬约束" (line 157) — and the ~9-line "公共硬约束" boilerplate covers generic concerns (API keys, SSRF, CHANGELOG, BAC) irrelevant to code recommendation, matching anchor 2's 'several unnecessary explanations or padded sections'. It is above anchor 1 because the core workflow sections are not concept-explanation padding and the scripts/TOML details are appropriately externalized. | 2 / 5 |
Actionability | The body provides copy-paste-ready commands: the workspace setup bash (TS=...; mkdir -p ...), the ranking script invocation with concrete flags (--input, --top-k 50, --prefix A, --output-dir), and the report-skeleton script with a cp to the delivery location, plus a concrete report template. It falls short of anchor 5 because the report-template block around lines 100-117 has a broken/ambiguous code fence — the list and table appear between an unterminated fence and a stray closing ``` — leaving the exact template boundaries unclear. | 4 / 5 |
Workflow Clarity | A clear sequence is present (timestamp/workspace → read-only body ingestion → deterministic coarse ranking → AI semantic selection of 5 pairs → skeleton generation → fill → copy to root), and a "失败与恢复" section covers error recovery, but the "校验" step is vague — "完成后执行 Skill 已有的静态检查、脚本验证或人工复核" names no concrete check or command (the bundled validate_skill.py is never referenced), matching anchor 3's 'validation gaps; checkpoints implicit'. It is above anchor 2 because steps are well defined and ordered, not rough. | 3 / 5 |
Progressive Disclosure | The 678KB recommendation library is correctly externalized to references/nsfc_code_recommend.toml and clearly signaled as "代码推荐覆盖库", and the two workflow scripts (nsfc_code_rank.py, nsfc_code_new_report.py) are referenced by real, one-level-deep paths — the bundle listing confirms they exist. It misses anchor 5 because references/demo/ and scripts/validate_skill.py sit unused in the bundle with no navigation or mention, and the output-file template is inlined into SKILL.md rather than split out. | 4 / 5 |
Total | 13 / 20 Passed |