Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured for progressive disclosure and highly actionable in its quick-start, with real bundle files backing the references. Its main weaknesses are the redundant verbatim overview and the lack of error/validation guidance around rate-limited API calls.
Suggestions
Remove the '概述' section (or shorten it to one line), since it duplicates the frontmatter description token-for-token.
Add a brief error-handling note for the quick start, e.g. check the returned DataFrame is empty, retry on rate-limit/500 errors, and paginate using start_date/end_date when hitting the per-request row cap.
Consider moving the 229-row interface catalog into a references/index.md and keeping only category groupings in SKILL.md to reduce the inline token load.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The '概述' section duplicates the frontmatter description verbatim, adding redundant tokens, and the 229-row interface table is heavy; the quick-start and parameter sections are lean, so it is mostly efficient but could be tightened. | 2 / 3 |
Actionability | Quick start provides executable commands ('pip install tushare -i ...', 'export TUSHARE_TOKEN=...') and a complete runnable Python snippet (pro.stock_basic with fields), plus links to real example scripts and concrete parameter formats (YYYYMMDD, ts_code), making it copy-paste ready. | 3 / 3 |
Workflow Clarity | Quick start is sequenced (install → register token → find interface in docs → write code), but there are no validation/error checkpoints or feedback guidance despite the table noting rate limits ('每次请求最多返回200条记录'), so checkpoints are missing for batch-prone API calls. | 2 / 3 |
Progressive Disclosure | Structure is well split: overview and quick start inline, per-interface detail one level deep under references/<category>/, and executable examples in scripts/, with the interface table serving as a clearly signaled navigation index to those reference files. | 3 / 3 |
Total | 10 / 12 Passed |