Content
71%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 — every script has an exact invocation, the multi-agent pipeline is numbered, and the data-source and quality-gate rules are concrete — but it is padded with implementation trivia and time-sensitive version detail, and its file navigation is inconsistent: existing references/ and assets/ files are never linked while multiple in-body links point to files absent from the bundle. Error-recovery behavior (gate rejection, parser failure, endpoint outage) is left implicit.
Suggestions
Link the existing bundle files from the body (references/机构白名单.md, references/评级体系说明.md, assets/研报分析模板.md) instead of inlining whitelist summaries, and either add the missing linked files (agents/*.md, config/settings.json, .env.example, requirements.txt) or remove/fix those references.
Trim vendor/accuracy/version detail (MinerU 98.7%, Python 3.10-3.13, xref/hash dedup internals) out of SKILL.md into a reference file or the pdf_parser docstring, keeping only the flag-level facts Claude needs (--mineru, extract_imgs, image_chain).
Add an explicit failure-handing branch to the workflow: what report_router.py does when the quality gate rejects reports, when all parsers in the text chain fail, or when the EastMoney endpoint is unreachable (e.g., fallback to websearch per the 数据源优先级 rule).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational (tables, CLI calls, API params, gate thresholds), but it carries noticeable non-essential detail: vendor attributions and accuracy claims ("OpenDataLab 出品...准确率 98.7%", "微软出品"), time-sensitive version constraints ("Python 3.10-3.13 + GB 级模型") inline rather than in a deprecated/reference section, and image-extraction internals (xref 去重, 内容哈希去重, why MarkItDown lacks page.images) that belong in a reference file. This sits at anchor 3 — mostly efficient with some unnecessary explanation to trim — rather than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: a per-script table with exact invocations, four full bash call chains (report_router stock/industry/list with flags and output paths), concrete API endpoints with parameter names and PDF URL pattern, and numeric quality-gate rules (≤90 days, >80% buy ratings, 25-institution whitelist). This matches anchor 5: fully executable commands covering the common cases. | 5 / 5 |
Workflow Clarity | The Team-First section gives a clearly sequenced 1→7 pipeline with named agents and the report_router entry point, and the 质量门禁 rules function as validation checkpoints for the batch fetch/download operations, so the missing-validation cap (≤3) does not apply. It stays at anchor 4 rather than 5 because failure handling is implicit — what happens when the quality gate rejects reports, a parser in the chain fails, or the EastMoney endpoint is unreachable is never stated. | 4 / 5 |
Progressive Disclosure | Section structure is decent (适用场景/运行原则/工具能力/数据源/约束/配置), but bundle navigation is unreliable: the body links to files that don't exist in the bundle (agents/*.md, ../PDF_IMAGE_RESEARCH.md, config/settings.json, .env.example, requirements.txt) while the bundle files that do exist — references/机构白名单.md, references/评级体系说明.md, assets/研报分析模板.md — are never referenced, with whitelist content instead inlined ("中信/中金/华泰/国君/海通等 25 家主流券商"). This matches anchor 3: structure present but references not clearly signaled and content that should live in the separate file kept inline. | 3 / 5 |
Total | 15 / 20 Passed |