AirswitchAsa/pokemon-wikis-cli

pokewiki

Suche in vier Pokémon-Wikis — Bulbapedia (en), 神奇宝贝百科 / 52poke (zh), PokéWiki (de), WikiDex (es) — über eine einheitliche englische CLI: pokewiki.

pokemon-wikis-cli ist ein inoffizielles, unabhängiges Tool — weder verbunden mit noch gebilligt von einem dieser Wikis oder The Pokémon Company.

Wann dieses Skill verwendet werden sollte

Greifen Sie darauf für jede faktische Pokémon-Frage zu: Typisierung/Werte/Fähigkeiten einer Spezies, Wirkung einer Attacke, Typeneffektivität, Entwicklungslinien, welche Pokémon ein Merkmal teilen, oder spielspezifische Fakten wie das verfügbare Pokémon-Aufgebot eines Titels, regionaler Pokédex oder aktuelle Wettbewerbsregeln.

Behandeln Sie die Wikis als die ultimative Quelle, nicht Ihr Gedächtnis. Pokémon-Wissen ist umfangreich, versioniert und wird häufig aktualisiert — Aufgebote ändern sich mit jeder Regel, Namen unterscheiden sich pro Sprache, und eine „Tatsache“, an die Sie sich erinnern, könnte aus dem falschen Spiel stammen oder einfach falsch sein. Wenn Genauigkeit wichtig ist, schlagen Sie nach, bevor Sie antworten. Der Aufwand einer Abfrage ist ein Befehl; der Aufwand, selbstbewusst einen falschen Typ, Wert oder „dieses Pokémon ist in diesem Spiel“ zu nennen, ist eine falsche Antwort, die der Benutzer korrigieren muss.

CLI erhalten

Lösen Sie den Befehl mit dem gebündelten Skript auf (dessen Pfad relativ zu dieser SKILL.md auflösen). Es gibt den zu verwendenden Befehl aus oder beendet sich mit einem Exit-Code ungleich Null und Installationsanweisungen:

scripts/ensure-pokewiki.sh

Es prüft in dieser Reihenfolge: ein bereits auf PATH befindliches pokewiki, dann uvx (führt es direkt von GitHub aus — keine Installation; uv cacht den Build nach der ersten Nutzung). Wenn keines vorhanden ist, gibt es Installationsoptionen aus und beendet sich mit 1 — installieren Sie nichts selbst; zeigen Sie die Optionen an und lassen Sie den Benutzer wählen.

Alle Beispiele unten schreiben pokewiki; ersetzen Sie es durch das, was das Skript ausgibt.

Ein Wiki auswählen: -w ist erforderlich

Jede Abfrage läuft gegen genau ein Wiki, ausgewählt mit -w / --wiki:

-w	Wiki	verwenden für
en	Bulbapedia	die breiteste englische Abdeckung; Standardwahl für Englisch
zh-hans	52poke (神奇宝贝百科)	Chinesische Abfragen; vereinfachte Ausgabe
zh-hant	52poke	Chinesische Abfragen; traditionelle Ausgabe
de	PokéWiki	Deutsch; kein CirrusSearch — einfache search funktioniert, aber search -c nicht; filter verwenden
es	WikiDex	Spanisch

Passen Sie das Wiki an die Sprache des Benutzers an oder daran, wo die Information lebt. Ein Seitentitel ist pro Wiki und wird nicht übersetzt — Pikachu auf en, 皮卡丘 auf zh-hans.

Die vier Befehle

Befehl	Verwenden, wenn
search <Anfrage>	Sie eine Seite finden müssen oder den genauen Titel nicht kennen (unscharfe Volltextsuche).
filter <Schlüssel…>	Sie jedes Pokémon möchten, das eine Schnittmenge von Merkmalen (Typ, Generation, Ei-Gruppe, Region, Fähigkeit) erfüllt.
page <Titel>	Sie die Seite (oder einen Namen, der darauf weiterleitet) kennen und ihren rohen Wikitext möchten — Werte, Typisierung, Fähigkeiten, Attacken.
keywords [Achse]	Sie die gültigen Constraints für filter sehen möchten.

pokewiki search "皮卡丘" -w zh-hans              # Seite durch unscharfen Namen finden
pokewiki page "Garchomp" -w en                   # roher Wikitext (folgt Weiterleitungen)
pokewiki filter type:dragon region:hisui -w en   # alle Hisui-Dex-Drachen-Typen
pokewiki keywords region -w en                   # gültige region:-Schlüssel auf Bulbapedia

Fügen Sie --format json zu jedem Befehl hinzu, um strukturierte Ausgabe zum Parsen zu erhalten; lassen Sie es weg, um Ergebnisse selbst zu lesen. Siehe references/cli.md für alle Flags und Exit-Codes.

Entscheidungshilfe

• Das genaue Subjekt bekannt (ein benanntes Pokémon, eine Attacke oder Fähigkeit) → page. Es folgt Weiterleitungen, sodass ein bloßer Name normalerweise zum Artikel führt.
• Auf der Suche nach der richtigen Seite / unsicherer Titel → search. Dann page des besten Treffers, um ihn zu lesen.
• Aufzählung nach Merkmal („Alle Elektro-Gen-1“, „Wasser/Boden-Typen“) → filter. Schlüssel werden UND-verknüpft; übergeben Sie sie leerzeichen- oder kommagetrennt.
• Eingrenzen einer Textsuche durch ein Merkmal → search "<Text>" -c type:electric (nur CirrusSearch-Wikis — nicht de).

Vokabular für filter-Constraints

Schlüssel sind englisch und werden auf die nativen Kategorien jedes Wikis abgebildet. Zwei Arten:

• Universell (identisch auf jedem Wiki): type: (18), gen: (1–9), egg: (14 Ei-Gruppen).
• Pro Wiki (nur wo das Wiki so kategorisiert): region: auf en (9) und zh (10); ability: nur auf zh (312). Die Verwendung eines Schlüssels auf einem Wiki, das ihn nicht hat, ist ein klarer Fehler, der die Wikis nennt, die ihn unterstützen.

Führen Sie pokewiki keywords für die Vereinigungsmenge aller Schlüssel aus, oder pokewiki keywords -w <wiki>, um die Schlüssel eines Wikis mit ihren nativen Kategorienamen zu sehen. Für alles außerhalb dieses Vokabulars verwenden Sie search.

Ein beispielhafter Ablauf: Mehrschritt-Abfragen

Echte Fragen verketten oft die Befehle — und die Verkettung ist auch die Art und Weise, wie Sie vermeiden, aus veraltetem Gedächtnis zu antworten. Um einen Konter gegen eine Bedrohung innerhalb des verfügbaren Aufgebots eines bestimmten Spiels zu finden:

1. search des Namens der Bedrohung, um zu bestätigen, dass Sie die richtige Seite haben.
2. page um ihre tatsächliche Typisierung, Werte und Fähigkeit zu lesen — nicht das, woran Sie sich erinnern.
3. page des Artikels über das Aufgebot/die Regelung des Spiels, um zu sehen, was tatsächlich verfügbar ist (dies ist der Schritt, der „Ich habe angenommen, X ist in diesem Spiel“ abfängt).
4. filter nach dem relevanten Typ innerhalb dieser Gruppe, um echte Optionen aufzuzählen.

Jeder Schritt ersetzt eine Annahme durch eine faktische Information aus dem Wiki. Wenn eine Abfrage dem widerspricht, was Sie sagen wollten, vertrauen Sie der Abfrage.

Compliance (nicht umgehen)

Dieses Tool ist bewusst höflich zu den Wikis, und das ist eine Eigenschaft. Es verwendet ausschließlich die MediaWiki-API (niemals Scraping), serialisiert und begrenzt die Rate von Anfragen, cacht für 24 Stunden und sendet einen identifizierenden User-Agent. Versuchen Sie nicht, es zu parallelisieren, den Cache in einer Schleife zu umgehen oder die japanischen/französischen/italienischen Wikis hinzuzufügen (ausgeschlossen, weil sie automatischen Zugriff blockieren). Wenn eine Anfrage gedrosselt wird (Exit-Code 4), warten Sie und wiederholen Sie sie einmal — nicht hämmern.

Referenzen

• references/cli.md — jeder Befehl, jedes Argument, jedes Flag, jede Ausgabeform und jeder Exit-Code.