Quantum Position Engine 仓位计算引擎指南。覆盖 Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断等核心风控逻辑。当需要计算仓位、检查风控参数、调试仓位引擎时使用此 Skill。
86
82%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
85%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that clearly defines a specialized trading/risk management position calculation engine. It excels at specificity with concrete technical capabilities and includes an explicit 'when to use' clause. The main weakness is that trigger terms are quite technical, which may not match how less technical users would phrase their requests.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断' (Decimal precision calculation, cross-currency exchange rate conversion, margin leverage checking, drawdown circuit breaker). These are concrete, technical capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断等核心风控逻辑') and when ('当需要计算仓位、检查风控参数、调试仓位引擎时使用此 Skill'). Has explicit 'Use when' equivalent clause with specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Contains domain-specific terms like '仓位计算' (position calculation), '风控' (risk control), '杠杆' (leverage), '保证金' (margin), but these are somewhat technical. Missing common variations or simpler user-facing terms that non-experts might use. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche: quantum position engine with trading/risk control focus. Terms like '仓位引擎', '保证金杠杆', '回撤熔断' are highly distinctive and unlikely to conflict with general coding or document skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that provides actionable guidance for using the position calculation engine. The content efficiently uses tables and code examples to convey complex information. Main weaknesses are the lack of explicit validation/debugging workflows and missing links to referenced source files or extended documentation.
Suggestions
Add a troubleshooting section with validation steps for common issues (e.g., unexpected zero position, margin降级 scenarios)
Include links to the referenced source files (models.py, calculator.py, etc.) or create a REFERENCE.md for API details
Add an error handling example showing how to interpret and respond to BLOCKED results or margin adjustments
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using tables and code blocks to convey information densely. No unnecessary explanations of concepts Claude already knows (like what Decimal is or why floating point has errors). | 3 / 3 |
Actionability | Provides fully executable Python code example with proper imports, concrete parameter values, and expected output format. The calculation flow is specific with exact formulas, and all input parameters are clearly documented. | 3 / 3 |
Workflow Clarity | The 7-step calculation flow is clearly sequenced with decision points (熔断检查, 保证金检查), but lacks explicit validation/verification steps for debugging or error recovery. No feedback loop for when calculations produce unexpected results. | 2 / 3 |
Progressive Disclosure | Good use of sections and tables for organization, but the architecture section references files (models.py, calculator.py, etc.) without linking to them. Could benefit from explicit links to detailed documentation for advanced topics like custom asset types or汇率服务 configuration. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
3069d33
Table of Contents
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.