Community写作与编辑github.com

AirswitchAsa/pokemon-wikis-cli

基于CLI的完全异步SDK,通过统一的英文接口合规访问四个宝可梦维基(Bulbapedia、52poke、PokéWiki、WikiDex)。

pokemon-wikis-cli 是什么?

这是一个专为开发者及AI助手设计的宝可梦维基知识查询CLI工具。它通过一个`pokewiki`英文命令,统一访问四个语种的主流宝可梦维基(英文Bulbapedia、中文神奇宝贝百科52poke、德文PokéWiki、西班牙文WikiDex),无需切换不同站点或语言界面。工具提供了`search`(模糊全文搜索)、`page`(精确标题获取原始维基文本)、`filter`(按属性交集筛选宝可梦)和`keywords`(查看筛选关键词)四个核心命令,支持JSON结构化输出,便于程序化处理。**适用场景**包括:核实宝可梦属性/特性/种族值、查找招式效果、分析属性克制、构建进化链、查询指定游戏的可登录宝可梦池等。工具严格遵循MediaWiki API频率限制,自带24小时缓存和请求节流机制,不会对维基站点造成压力。它避免了多个维基间的语言障碍,将事实查找的成本降为一条命令,特别适合需要高可靠性的游戏数据分析、对战策略制定或宝可梦数据库相关的开发任务。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add AirswitchAsa/pokemon-wikis-cli

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

pokewiki

跨四个宝可梦维基进行查询 —— Bulbapedia(英文)、神奇宝贝百科/52poke(中文)、PokéWiki(德文)、WikiDex(西班牙文)—— 全部通过一个英文CLI命令:pokewiki。

pokemon-wikis-cli 是一个非官方的独立工具,与上述任何维基或宝可梦公司无关联或背书。

何时使用此技能

适用于任何宝可梦相关的事实性问题:某个宝可梦的属性/种族值/特性、某个招式的效果、属性克制关系、进化链、哪些宝可梦共享某一特征,或者特定游戏内的可登录宝可梦池、地区图鉴、当前竞标赛规则等。

将维基视为事实来源,而非你的记忆。 宝可梦细节庞杂、版本繁多且更新频繁——可登录宝可梦池随规则变化,名称因语言而异,你记忆中的某个“事实”可能来自错误版本或纯属错误。当准确性至关重要时,先查询再回答。一次查询的成本不过是一条命令;而自信地报错属性、种族值或“该宝可梦可在本作中获得”的代价,是用户必须纠正的错误答案。

获取CLI

通过捆绑脚本解析命令(相对于此 SKILL.md 的路径)。它会打印要使用的命令,如果找不到则退出非零状态并附带安装说明:

scripts/ensure-pokewiki.sh

该脚本按顺序检查:PATH 上是否已有 pokewiki,然后检查 uvx(直接从GitHub运行,无需安装;首次使用后uv会缓存构建)。如果两者都不存在,则打印安装选项并退出 1 ——请勿自行安装;只需列出选项让用户选择。

以下所有示例均写作 pokewiki;请替换为脚本实际打印的命令。

选择维基:-w 为必选项

每次查询针对一个维基,使用 -w / --wiki 选择:

-w维基使用场景
enBulbapedia最广泛的英文覆盖;英文查询的默认选择
zh-hans52poke(神奇宝贝百科)中文查询;简体输出
zh-hant52poke中文查询;繁体输出
dePokéWiki德文;无 CirrusSearch —— 普通 search 可用,但 search -c 不可用;请使用 filter
esWikiDex西班牙文

根据用户语言或事实所在的维基进行匹配。页面标题是各维基独立的且不翻译 —— 英文为 Pikachu,中文简体为 皮卡丘。

四个命令

命令使用场景
search <query>你需要查找某个页面,或不确定确切标题(模糊、全文搜索)。
filter <keys…>你想获取所有满足多个属性交集(属性、世代、蛋组、地区、特性)的宝可梦。
page <title>你知道页面(或重定向到它的名称)并希望获取原始维基文本——种族值、属性、特性、招式。
keywords [axis]你需要查看 filter 的有效约束键。
pokewiki search "皮卡丘" -w zh-hans              # 按模糊名称查找页面
pokewiki page "Garchomp" -w en                   # 原始维基文本(跟随重定向)
pokewiki filter type:dragon region:hisui -w en   # 所有洗翠图鉴龙属性宝可梦
pokewiki keywords region -w en                   # Bulbapedia上有效的 region: 键

向任何命令添加 --format json 可获取结构化输出以便解析;省略则以可读形式显示结果。参见 references/cli.md 了解所有标志和退出码。

如何选择

  • 知道确切主题(已命名的宝可梦、招式或特性)→ page。它能跟随重定向,因此简单的名称通常能直接解析到文章。
  • 查找正确的页面/不确定标题 → search。然后对最佳匹配使用 page 阅读。
  • 按属性枚举(“所有电系一代”、“水/地面属性”)→ filter。键为AND交集;用空格或逗号分隔。
  • 按属性缩小文本搜索范围 → search "<text>" -c type:electric(仅限支持CirrusSearch的维基 —— 不适用于 de)。

filter 的约束词表

键为英文,并解析到各维基的原生分类。包括两种:

  • 通用键(每个维基相同):type:(18种)、gen:(1–9代)、egg:(14个蛋组)。
  • 维基特有键(仅在该维基有相应分类时才有效):region: 在 en(9个地区)和 zh(10个地区)上;ability: 仅在 zh 上(312个特性)。在不支持该键的维基上使用它会明确报错,并列出支持该键的维基。

运行 pokewiki keywords 查看所有键的并集,或运行 pokewiki keywords -w <wiki> 查看某个维基的键及其原生分类名称。对于超出此词表的查询,请使用 search。

一种典型工作模式:多步查询

真实问题通常需要链式使用命令——这也是避免凭过时记忆回答的方法。要针对某个特定游戏内可用宝可梦池找到威胁的反制手段:

  1. search 威胁的名称,确认你已找到正确页面。
  2. page 该页面以读取其真实属性、种族值和特性——而非你的回忆。
  3. page 该游戏的图鉴/规则文章以查看实际可用的宝可梦(这一步可以捕捉“我假设X在该游戏中”的错误)。
  4. filter 在该池中按相关属性筛选以枚举真实选项。

每一步都将一个假设替换为来自维基的事实。当查询结果与你即将说出的内容矛盾时,请相信查询结果。

合规性(请勿绕过)

此工具刻意保持对维基的礼貌,且这本身就是一个特性。它仅使用MediaWiki API(绝不抓取),序列化并限流请求,缓存24小时,并发送标识性User-Agent。请勿尝试并行化、在循环中绕过缓存,或添加日文/法文/意大利文维基(这些被排除是因为它们阻止自动访问)。如果请求被限流(退出码4),请等待并重试一次——不要猛发请求。

参考

  • references/cli.md —— 每个命令、参数、标志、输出形状和退出码。

相关技能