pokemon-champions-dex · diff
git:20260628.9de3cd7 to git:20260710.66eec11
43 added, 33 removed. Audit A to A.
---
name: pokemon-champions-dex
- description: Offline-first Pokemon Champions battle dex lookup with trilingual aliases (Chinese / English / Japanese), batch queries, and multi-condition reverse search. Use when you need to check Pokemon Champions or Regulation M-B battle-dex facts such as Pokemon/forms, Chinese/English/Japanese names, types, base stats, abilities, moves, learnsets, Mega stones, item availability, or to answer queries like "who learns Close Combat and is Flying type" while building or reviewing teams.
+ description: Offline-first Pokemon Champions battle dex lookup with trilingual aliases (Chinese / English / Japanese), batch queries, and multi-condition reverse search. Use when the request asks for a canonical dex fact about a Pokemon/form/move/ability/item/nature/name, not for popularity trends or damage arithmetic. Chinese examples include "X能学Y吗", "谁会Y", "X是什么属性/种族值/特性", "X的中文/日文/英文名", "这个名字对应谁", "这个Mega石给谁用". English examples include "can X learn Y", "who learns Y", "what are X's types/stats/abilities", "resolve this name", "which form/item is this". Japanese examples include "XはYを覚える？", "Yを覚えるポケモン", "Xのタイプ/種族値/特性", "この名前はどのポケモン？", "このメガストーンの対応先は？". Use it while building or reviewing teams whenever a factual dex claim or name normalization is needed.
---
# Pokemon Champions Dex
- Use this skill to query a local Pokemon Champions battle dex before making team-building claims. It is separate from environment usage/ranking data: it answers "what can this Pokemon be or learn?" rather than "what is popular?".
+ Query the bundled Pokemon Champions battle dex before making factual claims about a Pokemon, form,
+ move, ability, item, nature, or learnset. This skill answers "what exists and what can it learn?";
+ metagame popularity belongs to `$pokemon-champions-meta`, and damage arithmetic belongs to
+ `$ncp-damage-calculator`.
- ## Quick Start
+ ## Workflow
- Run the query CLI:
+ 1. Use `resolve` to normalize free-form Chinese, English, or Japanese names. It is batch,
+ typo-tolerant by default, understands multilingual Mega forms, and preserves 1:1 input order.
+ 2. Use the entity commands or `batch` when full records are needed.
+ 3. Use `find` / `find-move` for reverse search; use `--where` for OR, NOT, or nested conditions.
+ 4. Prefer `--format json` for downstream processing. Use `--lang zh|ja|en` only for human-readable
+ Markdown output.
- ```bash
- python scripts/champdex.py pokemon 姆克鹰 Mega-Staraptor 巨金怪
- python scripts/champdex.py move 近身战 Close-Combat
- python scripts/champdex.py ability 唱反调 Contrary
- ```
+ ## Commands
- Names resolve in Chinese, English, or Japanese (kana), so Japanese-source inputs work directly. Full-width and half-width forms both match (`１０まんボルト` = `10まんボルト`):
+ Normalize names first when the input is free-form:
```bash
- python scripts/champdex.py pokemon ガブリアス ミミッキュ
- python scripts/champdex.py move じしん 10まんボルト
- python scripts/champdex.py find type 龍 learns じしん
+ python scripts/champdex.py resolve Mega耿鬼 超级雪妖女 牛蛙君 咆哮虎
+ python scripts/champdex.py resolve 灭亡之歌 地震 保护 --kind move
```
- Name lookups are typo-tolerant by default: an exact match is used when present, otherwise a close misspelling resolves to the nearest entity and the result carries a `resolution` block flagging the correction; an ambiguous tie refuses rather than guessing (and returns `suggestions`). Pass `--strict` to disable the fallback when a miss must stay a miss (validation/integrity). `find`/`reverse` are always exact.
-
- Use batch mode when a prompt lists many Pokemon, moves, abilities, or items:
+ Query one or many full records:
```bash
+ python scripts/champdex.py pokemon 姆克鹰 Mega-Staraptor 巨金怪
+ python scripts/champdex.py move 近身战 Close-Combat
+ python scripts/champdex.py ability 唱反调 Contrary
+ python scripts/champdex.py item 耿鬼进化石 Gengarite
+ python scripts/champdex.py nature 固执 Adamant
python scripts/champdex.py batch pokemon 姆克鹰 巨金怪 弃世猴 洗衣机
```
- Use `find` or `reverse` for reverse and multi-condition lookup:
+ Reverse-search Pokemon or moves:
```bash
python scripts/champdex.py find move 近身战 type 飞行
- python scripts/champdex.py find ability 唱反调 type 飞行
python scripts/champdex.py find type 水 type 地面 stat spe>=70
- python scripts/champdex.py reverse move Close-Combat --format json
+ python scripts/champdex.py find-move type Fire category Special power ">=90"
+ python scripts/champdex.py find --where '{"and":[{"type":"Dragon"},{"not":{"mega":true}}]}'
```
- The positional condition grammar is `field value field value ...`. Supported fields are `pokemon`, `move`, `ability`, `item`, `type`, `stat`, `mega`, and `name`. Stat conditions accept `hp>=80`, `atk>120`, `spe<=70`, plus aliases `at/atk`, `df/def`, `sa/spa`, `sd/spd`, `sp/spe`.
-
- ## Data Files
+ Names accept Chinese, English, and Japanese aliases. Exact aliases win; typo fallback is conservative,
+ reports its correction, and refuses ambiguous ties. Use `--strict` when validation requires exact-only
+ resolution. `find` and `reverse` are always exact. The full positional and boolean grammars are exposed
+ by the CLI schema.
- The skill ships a prebuilt, read-only database. It performs no network access and does not regenerate its own data.
+ ## Contract And Output
- - `data/champions_dex.sqlite`: primary offline database (queried by `champdex.py`).
- - `data/champions_dex.json`: portable JSON export.
+ Treat the executable schema as the authority for commands, fields, canonical stat keys, and errors:
- Read `references/schema.md` when you need to understand database fields or query behavior.
+ ```bash
+ python scripts/champdex.py schema
+ ```
- ## Team-Building Usage
+ Canonical JSON is language-independent: English `name` is the cross-skill join key; stat keys and type
+ values remain canonical English. Human-readable output language precedence is `--lang`, then
+ `POKEMON_CHAMPIONS_LANG`, then `en`.
- When building or reviewing a team, query this skill for factual checks before claiming:
+ Read `references/schema.md` only when database fields, name-resolution behavior, or reverse-query
+ semantics are relevant. It supplements the executable schema rather than replacing it.
- - a Pokemon's Champions typing, stats, ability, or Mega stone;
- - whether a Pokemon/form can use a move in Champions;
- - which Pokemon satisfy a combined constraint such as `move 近身战 type 飞行`;
- - Chinese/English/Japanese name resolution for screenshots, Japanese-source data, or user shorthand.
+ ## Boundaries
- Do not infer strategic roles from this skill. It intentionally does not generate role tags because Pokemon sets are flexible and tags can bias team-building reasoning.
+ - The bundled SQLite database and JSON mirror are read-only; the skill performs no network access.
+ - Report dex facts and legality-relevant learnset facts, not popularity or strategic role labels.
+ - A valid dex lookup is not a metagame recommendation. Use the sibling skills for usage and damage.