CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tqsdk-trading-and-data

使用 TqSdk Python SDK 获取行情与历史数据、编写或排查交易与回测程序,并在需要本地运行时检查环境、安装缺失的 TqSdk。适用于明确使用 TqSdk、TqApi、TargetPosTask 等接口的开发、数据和账户问题;通用金融问答或其他数据产品不必使用本技能。

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, TqSdk-specific instruction set: a validated 5-step workflow with feedback loops, a task-indexed reference table backed by an actual bundle, and dense rules encoding SDK semantics Claude would otherwise get wrong. The only gap is the absence of any inline code snippet, with executable detail delegated to references.

DimensionReasoningScore

Conciseness

Every line carries TqSdk-specific knowledge Claude would not already know — `iloc[-1]` is a forming bar, `insert_order()` return vs fill, `TargetPosTask` not mixed with manual orders, `KQ.m@` main-continuous contracts, `BacktestFinished` handling — with zero filler or basic-concept padding. This matches the 5 anchor ('lean and efficient; assumes Claude's competence; every token earns its place').

5 / 5

Actionability

Guidance is highly concrete: a runnable script ([scripts/check_environment.py](scripts/check_environment.py)), a specific status to branch on (`not_installed`), and exact fields and functions (`volume_left`, `last_msg`, `underlying_symbol`, `account=`, `finally: api.close()`). It stops short of the 5 anchor's 'copy-paste ready code or commands' since the body has no inline code snippet, but per the rubric's code-vs-instruction note this is a minor gap, not a failing.

4 / 5

Workflow Clarity

The 5-step 开始处理 sequence has explicit validation checkpoints and feedback loops: run the environment script, branch on `not_installed`, install per environment-setup.md, verify the import, then 验证并交付 requires syntax/import checks before data/output/backtest verification, plus a live-trading authorization check ('执行实盘下单或撤单前,确认操作参数在用户已有授权范围内'). This matches the 5 anchor (clear sequence, explicit validation, error-recovery loops).

5 / 5

Progressive Disclosure

SKILL.md is a concise overview with a task→reference table mapping 11 real, one-level-deep reference files (all verified to exist), plus the bundled script; the reference files themselves only link to sibling files and external URLs, with no nested chains. This matches the 5 anchor (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a strong, concrete statement of capabilities with an explicit 'Use when' clause naming specific trigger interfaces and an explicit exclusion boundary. Its only weakness is missing a few natural synonyms (e.g., 天勤/天勤量化, 期货) that users might say instead of TqSdk.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "获取行情与历史数据", "编写或排查交易与回测程序", "检查环境、安装缺失的 TqSdk" — covering the skill's data, code, troubleshooting, and environment scope comprehensively. It matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); the 4 anchor ('minor gaps') would understate this breadth.

5 / 5

Completeness

Both what and when are explicit: what — "获取行情与历史数据、编写或排查交易与回测程序...检查环境、安装缺失的 TqSdk"; when — "适用于明确使用 TqSdk、TqApi、TargetPosTask 等接口的开发、数据和账户问题" plus the explicit exclusion "通用金融问答或其他数据产品不必使用本技能". This matches the 5 anchor (clear what AND when with concrete trigger phrases), exceeding the 4 anchor's 'when could be more explicit'.

5 / 5

Trigger Term Quality

Good keyword coverage with concrete trigger names users would say: "TqSdk", "TqApi", "TargetPosTask", "行情", "历史数据", "回测", "账户". It misses common natural synonyms such as the Chinese brand name "天勤"/"天勤量化", "shinny", or "期货", so it falls short of the 5 anchor's 'comprehensive coverage including synonyms'.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous: it names the specific SDK and its interfaces ("TqSdk Python SDK", "TqApi", "TargetPosTask") and explicitly excludes generic finance Q&A and other data products, giving it clear distinct triggers with minimal conflict risk — a direct match to the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

shinnytech/tqsdk-python

Path

doc/ai_editor/skills/tqsdk-trading-and-data/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.