@evatick/skill 0.4.0 → 0.4.2

package/README.md

@@ -1,10 +1,13 @@
-# EVA Skill for Codex
+# EVA Tick Skill for Codex
 
-This package installs the EVA Codex Skill, which teaches Codex how to select and
-use the locally installed `eva` CLI safely and predictably.
+Teach Codex how to discover financial instruments and query market data through
+the EVA Tick CLI safely and predictably.
 
-The Skill package depends on the matching EVA CLI version, so one npm command
-installs both the `eva` command and the Skill installer:
+The package installs the EVA Tick Skill and depends on the exact matching
+version of `@evatick/cli`, so one npm command installs both the `eva` command and
+the Skill installer.
+
+## Install
 
 ```shell
 npm install --global @evatick/skill
@@ -12,15 +15,69 @@ eva-skill install
 eva-skill status
 ```
 
-Restart Codex after installing or updating a Skill so it can rediscover the
-instructions. To update an existing installation while preserving a recoverable
-backup:
+Restart Codex after installing or updating the Skill so it can rediscover the
+instructions.
+
+## Try it in Codex
+
+Ask Codex:
+
+- “搜索平安银行并告诉我它的规范金融标的 ID。”
+- “查询平安银行最近三个交易日的前复权日线。”
+- “检查 000001 是股票还是指数。”
+- “查询沪深 300 的指数成分并导出 CSV。”
+- “分别查询 Binance 和 Coinbase 的 BTC-USDT 行情，不要混用交易所。”
+
+The Skill helps Codex select and sequence the appropriate `eva` commands from a
+natural-language request.
+
+## What the Skill does
+
+The Skill instructs Codex to:
+
+1. Check the locally installed CLI and the configured EVA Tick service.
+2. Search or resolve uncertain instrument input before requesting data.
+3. Prefer canonical instrument IDs when a name or trading code is ambiguous.
+4. Inspect leaf-command help before unfamiliar calls.
+5. Parse stdout as one strict JSON value and handle structured errors.
+6. Report the requested instrument, period, and known data limitations.
+
+The Skill teaches Codex how to use the CLI; the EVA Tick Server owns provider
+routing, fallback, retries, normalization, and catalog persistence.
+
+## Safety and data boundaries
+
+- Never exposes API keys from environment variables or configuration files.
+- Never adds `--overwrite` without user authorization.
+- Does not call upstream data providers directly when EVA Tick fails.
+- Does not invent unsupported commands, markets, or asset capabilities.
+- Treats market data as research and reference material, not investment advice.
+
+The current service contract covers mainland China A-shares, Chinese indices,
+official CFFEX, SHFE, INE, and CZCE futures, and exchange-scoped Binance and
+Coinbase cryptocurrency market data. Futures support unadjusted daily bars.
+Cryptocurrency commands require an explicit venue. Availability depends on the
+configured service and its enabled providers.
+
+## Update
 
 ```shell
 npm update --global @evatick/skill
 eva-skill update
+eva-skill status
 ```
 
-`eva-skill` installs into `$CODEX_HOME/skills/eva`, or `~/.codex/skills/eva`
-when `CODEX_HOME` is unset. It does not use npm lifecycle scripts and never
-silently overwrites an existing Skill.
+`eva-skill update` replaces the installed Skill and preserves the previous copy
+as a recoverable backup. Automated removal of the copied Skill is not currently
+provided.
+
+The Skill is installed into `$CODEX_HOME/skills/eva`, or
+`~/.codex/skills/eva` when `CODEX_HOME` is unset. It does not use npm lifecycle
+scripts and never silently overwrites an existing Skill.
+
+## Documentation
+
+- [EVA Tick Skill source](https://github.com/xiaochaohit/evatick-cli/tree/main/skills/eva)
+- [Complete command guide](https://github.com/xiaochaohit/evatick-cli/blob/main/skills/eva/references/command-guide.md)
+- [EVA Tick CLI documentation](https://github.com/xiaochaohit/evatick-cli#readme)
+- [EVA Tick Server and OpenAPI](https://github.com/xiaochaohit/evatick-server)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@evatick/skill",
-  "version": "0.4.0",
-  "description": "Codex Skill for using the EVA market data CLI",
+  "version": "0.4.2",
+  "description": "Codex Skill for discovering instruments and querying financial data through the EVA Tick CLI",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,8 +22,18 @@
   "engines": {
     "node": ">=18"
   },
+  "keywords": [
+    "eva-tick",
+    "codex",
+    "codex-skill",
+    "agent-skill",
+    "ai-agent",
+    "financial-data",
+    "market-data",
+    "automation"
+  ],
   "dependencies": {
-    "@evatick/cli": "0.4.0"
+    "@evatick/cli": "0.4.2"
   },
   "publishConfig": {
     "access": "public"

package/skill/eva/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: eva
-description: Query and export mainland A-share and Chinese index data through the locally installed EVA CLI and EVA service. Use for instrument listing, search, resolution and inspection; stock and index quotes or bars; index constituents; EVA service health checks; and EVA CLI HTTP or authentication troubleshooting.
+description: Query and export mainland A-share, Chinese index, mainland futures, and exchange-scoped cryptocurrency data through the locally installed EVA CLI and EVA service. Use for instrument discovery; stock, index, futures, or crypto quotes and bars; index constituents; service health checks; and CLI HTTP or authentication troubleshooting.
 ---
 
 # Use EVA
@@ -25,12 +25,13 @@ v1 command tree, output options, configuration, and error handling.
 
 - Use named options only.
 - Prefer canonical instrument IDs when a symbol or name is ambiguous.
+- For cryptocurrency queries, always pass `--venue BINANCE` or `--venue COINBASE`; never combine or substitute prices across venues.
 - Use ISO dates such as `2026-08-15` for `--start`, `--end`, and `--as-of`.
 - Use `--output PATH` for large results. Add `--format` only to select `json`, `jsonl`, `csv`, or `parquet`.
 - Do not add `--overwrite` without user authorization.
 - Never expose API keys from environment variables or configuration files.
 - Let the EVA service handle provider routing. Report retryable service failures instead of calling providers directly.
-- Do not invent unsupported commands for funds, futures, options, bonds, FX, macro data, calendars, or alternative data.
+- Futures support unadjusted daily bars from CFFEX, SHFE, INE, and CZCE. Do not invent unsupported commands for funds, options, bonds, FX, macro data, calendars, or alternative data.
 
 ## Quick sequence
 
@@ -39,4 +40,5 @@ eva health
 eva instrument search --query 平安银行 --type equity
 eva stock bars --help
 eva stock bars --symbol 000001 --start 2026-08-01 --end 2026-08-15 --limit 20
+eva crypto quotes --symbol BTC-USDT --venue BINANCE
 ```

package/skill/eva/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "EVA"
-  short_description: "通过 EVA CLI 查询、解析并导出中国股票和指数数据"
+  short_description: "通过 EVA CLI 查询并导出股票、指数、期货和交易所加密货币数据"
   default_prompt: "Use $eva to find and run the right EVA market data command."

package/skill/eva/references/command-guide.md

@@ -26,21 +26,32 @@ eva health
 eva version
 eva config set|show
 
-eva instrument list [--type equity|index] [--venue VENUE] [--publisher PUBLISHER]
-eva instrument search --query TEXT [--type equity|index]
-eva instrument resolve --query TEXT [--type equity|index]
+eva instrument list [--type equity|index|future|crypto] [--venue VENUE] [--publisher PUBLISHER]
+eva instrument search --query TEXT [--type equity|index|future|crypto] [--venue VENUE]
+eva instrument resolve --query TEXT [--type equity|index|future|crypto] [--venue VENUE]
 eva instrument show --id CANONICAL_ID
 
 eva stock quotes --symbol SYMBOL_OR_ID
-eva stock bars --symbol SYMBOL_OR_ID [--interval INTERVAL] [--start DATE] [--end DATE]
+eva stock bars --symbol SYMBOL_OR_ID [--interval INTERVAL] [--start DATE] [--end DATE] [--adjustment none|forward|backward] [--as-of DATE]
 
 eva index quotes --symbol SYMBOL_OR_ID
 eva index bars --symbol SYMBOL_OR_ID [--interval INTERVAL] [--start DATE] [--end DATE]
 eva index constituents --symbol SYMBOL_OR_ID [--as-of DATE]
+
+eva futures quotes --symbol SYMBOL_OR_ID
+eva futures bars --symbol SYMBOL_OR_ID [--interval 1d] [--start DATE] [--end DATE]
+
+eva crypto quotes --symbol SYMBOL_OR_ID --venue BINANCE|COINBASE
+eva crypto bars --symbol SYMBOL_OR_ID --venue BINANCE|COINBASE [--interval INTERVAL] [--start DATE] [--end DATE]
 ```
 
 Supported bar intervals are `1m`, `5m`, `15m`, `30m`, `60m`, `1d`, `1w`, and
-`1mo`. Inspect leaf help for context and adjustment options.
+`1mo`. Stock bars can be forward- or backward-adjusted. `--as-of` selects the
+forward-adjustment anchor date; indices and cryptocurrencies only support
+unadjusted bars. Coinbase supports `1m`, `5m`, `15m`, `60m`, and `1d`; Binance
+supports every listed interval. Cryptocurrency commands require an exchange
+venue and never fall back to the other exchange. Chinese futures use official
+CFFEX, SHFE, INE, and CZCE sources and support unadjusted daily bars.
 
 ## Results and files