Content
65%Reviews 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 concrete commands and error recovery, but it is verbose with repeated frontmatter guidance and fails to offload themes/troubleshooting into the existing reference files, leaving them orphaned.
Suggestions
Replace the inlined 主题选项/自定义主题 and 故障排查 sections with one-level-deep links to references/themes.md and references/troubleshooting.md, keeping only a concise summary inline.
Deduplicate the frontmatter (title+cover) guidance — state the mandatory fields and cover-source examples once instead of three times across the document.
Add an explicit validation checkpoint to the publish workflow (e.g., verify the draft appears in the 公众号 backend before final publish) with a validate→fix→retry loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~321-line body repeats the same frontmatter requirement (title + cover both mandatory) three times and re-shows the relative/absolute/network cover examples twice; it is mostly useful but could be tightened by removing the duplication and '实测' commentary padding. | 2 / 3 |
Actionability | It provides concrete, copy-paste-ready commands — 'npm install -g @wenyan-md/cli', 'wenyan publish -f article.md -t lapis -h solarized-light', exact env-var exports, and precise error-message-to-solution mappings in troubleshooting. | 3 / 3 |
Workflow Clarity | The quick-start and 工作流程 sections give a clear sequence with a manual review step and a troubleshooting section, but validation is implicit (manual '审核') rather than explicit checkpoints integrated into the numbered workflow with validate→fix→retry loops. | 2 / 3 |
Progressive Disclosure | Bundle files references/themes.md and references/troubleshooting.md exist but are never linked from the body, while their content (themes, troubleshooting) is fully inlined in SKILL.md — content that should be separate is inline and existing references are not signaled. | 2 / 3 |
Total | 9 / 12 Passed |