关于 pp-pokeapi
pp-pokeapi 是通过 pokeapi-pp-cli 使用本地可查询图鉴的技能，适用于 Pokémon 查询、对战和队伍规划。它提供反向搜索与分析，超出直接查找范围；所有命令均为只读。
主要功能
- 01搜索 Pokémon、招式、特性、道具和地点
- 02按特性查找 Pokémon，按效果查找招式
- 03分析队伍属性缺口与覆盖情况
- 04比较形态、历史和可学习招式
- 05计算招式伤害范围
- 06通过只读 SQL 查询本地数据
适用场景
- 01按效果和目标属性查找招式
- 02评估对战队伍的属性弱点
- 03比较两种形态的可学习招式
- 04查询目标 Pokémon 的进化条件
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/pp-pokeapi确认已加载。
详细介绍
PokéAPI — Printing Press CLI
先决条件：安装 CLI
此技能通过 pokeapi-pp-cli 二进制文件运行。调用此技能中的任何命令之前，必须确认 CLI 已安装。 如果尚未安装，请先安装：
- 通过 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到
$HOME/.local/bin；在 Windows 上，默认安装到%LOCALAPPDATA%\Programs\PrintingPress\bin：npx -y @mvanhorn/printing-press-library install pokeapi --cli-only - 验证：
pokeapi-pp-cli --version - 确保报告的安装目录位于将调用此技能的 Agent/运行时的
$PATH中。
如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）：
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/pokeapi/cmd/pokeapi-pp-cli@latest
如果安装后 --version 报告“command not found”，则运行时无法在 $PATH 中找到该二进制文件目录。验证成功之前，不要执行技能命令。
何时使用此 CLI
如果你需要一部完全本地、可全面查询的宝可梦图鉴，请使用此 CLI。它非常适合无需调用实时 API 即可回答宝可梦问题的 Agent、结合属性计算与可学招式筛选的对战规划工作流，以及实时 REST 接口无法直接回答的反向搜索问题（查找招式、特性、形态或进化条件）。如果工作流完全依赖图像，且已有其他工具能够处理宝可梦 sprite 的渲染，则无需使用它。
何时不使用此 CLI
对于需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或更改远程状态的请求，不要启用此 CLI。此打印版 CLI 仅提供用于检查、导出、同步和分析的只读命令。
独特功能
其他任何适用于此 API 的工具都不具备这些功能。
会不断增值的本地存储
-
pokemon by-ability— 查找拥有指定特性的所有宝可梦。实时 API 没有反向索引，因此这只需对本地存储执行一次 SQL 查询。当 Agent 需要按特性列出宝可梦，而不想发出数千次 API 调用时，使用此工具。
pokeapi-pp-cli pokemon by-ability levitate --json --select name,types -
move find— 按状态效果、伤害类别、属性或目标查找招式，例如：所有能使钢属性宝可梦麻痹的招式。当战斗规划问题是按效果而非招式名称提出时，使用此工具。
pokeapi-pp-cli move find --effect paralyze --type-target steel --json -
team suggest— 根据一支正在组建的队伍，评估每只剩余宝可梦对弥补队伍属性短板的效果，并返回最佳候选。最适合需要客观评估属性覆盖短板，而非凭感觉给出建议的组队 Agent。
pokeapi-pp-cli team suggest pikachu,charizard --slots 6 --json --select name,types,score -
pokemon diff-learnset— 比较两只宝可梦的招式学习列表（通常是地区形态或超级进化形态），并指出各自能学会而对方不能学会的招式。当 Agent 需要用具体招式证据说明“为什么选形态 X 而不是形态 Y”时，此工具很有用。
pokeapi-pp-cli pokemon diff-learnset charizard charizard-mega-x --json -
pokemon history— 展示宝可梦在不同世代间的变化：属性、种族值、特性，以及它首次登场的世代。回答宝可梦历史问题时使用（例如“皮皮一直都是妖精属性吗？”）。
pokeapi-pp-cli pokemon history clefairy --json -
pokemon forms— 列出某个物种的所有形态（例如六尾与阿罗拉六尾），并直接显示属性、种族值和特性的差异。当 Agent 需要涵盖整个物种的答案，而非单一形态的数据时使用。
pokeapi-pp-cli pokemon forms vulpix --json -
evolve into— 给定目标宝可梦，列出需要进化的宝可梦物种及进化条件（道具、等级、亲密度、时段）。当用户知道自己想要哪只宝可梦，并需要了解如何进化得到它，而不是反向查询时，选择此工具。
pokeapi-pp-cli evolve into umbreon --json -
team gaps— 列出 18 种属性中，你正在组建的队伍既没有防御抗性、也没有攻击克制效果的属性。回答“对手队伍最可能利用这套阵容的哪些弱点？”时使用。
pokeapi-pp-cli team gaps pikachu,charizard,blastoise --json -
encounters by-region— 联结地点、区域、遭遇记录和物种，生成地区级遭遇表，列出你能在（例如）关都地区遇到的所有宝可梦。适用于地区类问题（“在关都地区能抓到什么？”），而非针对单只宝可梦的问题。
pokeapi-pp-cli encounters by-region kanto --version red --json
面向 Agent 的底层工具
-
search— 对宝可梦、招式、特性、道具和地点进行全文搜索，搜索名称和风味文本，并按相关性排序。当名称不完整或模糊时，可作为 Agent 的备用方案；无需再组合多次列表调用和 grep。
pokeapi-pp-cli search "flame" --type move --limit 10 --json -
sql— 对本地存储进行只读 SQL 访问。高级用户和 Agent 可以编写 CLI 未直接提供的联结查询。当临时问题没有专用子命令时，使用此工具。
pokeapi-pp-cli sql "SELECT id FROM resources WHERE resource_type='pokemon' ORDER BY id LIMIT 10" --json
战斗计算
-
damage— 计算一只宝可梦对另一只宝可梦使用招式时的预期伤害范围，并计入 STAB、属性相克、等级和种族值。对于所有以“能一击击倒吗？”或“X 打 Y 有多疼？”为核心的战斗规划问题，都使用此工具。
pokeapi-pp-cli damage charizard blastoise hydro-pump --level1 50 --level2 50 --json -
pokemon top— 按种族值（攻击、特攻、速度、HP 等）为宝可梦排名，还可按属性筛选。返回前 N 名。了解对战环境，或为队伍补充特定定位时使用，尤其适合“哪只 Y 属性宝可梦最擅长 X？”这类问题。
pokeapi-pp-cli pokemon top --by special-attack --type ghost --limit 10 --json
命令参考
ability — 管理特性
pokeapi-pp-cli ability list— 特性会在战斗或野外为宝可梦提供被动效果。宝可梦可能拥有多种可选……pokeapi-pp-cli ability retrieve— 特性会在战斗或野外为宝可梦提供被动效果。宝可梦可能拥有多种可选……
berry — 管理树果
pokeapi-pp-cli berry list— 树果是小型水果，可以恢复 HP 和异常状态、提升能力，甚至造成伤害……pokeapi-pp-cli berry retrieve— 树果是小型水果，可以恢复 HP 和异常状态、提升能力，甚至造成伤害……
berry-firmness — 管理树果硬度
pokeapi-pp-cli berry-firmness list— 树果有软有硬。查看 [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Category:Berries_by_firmne...pokeapi-pp-cli berry-firmness retrieve— 树果有软有硬。查看 [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Category:Berries_by_firmne...
berry-flavor — 管理树果口味
pokeapi-pp-cli berry-flavor list— 口味根据宝可梦的性格决定其食用树果后的受益或受损情况。查看……pokeapi-pp-cli berry-flavor retrieve— 口味根据宝可梦的性格决定其食用树果后的受益或受损情况。查看……
characteristic — 管理特征
pokeapi-pp-cli characteristic list— 特征表示宝可梦哪项能力拥有最高的个体值。宝可梦的特征由……决定pokeapi-pp-cli characteristic retrieve— 特征表示宝可梦哪项能力拥有最高的个体值。宝可梦的特征由……决定
contest-effect — 管理华丽大赛效果
pokeapi-pp-cli contest-effect list— 华丽大赛效果指招式在华丽大赛中使用时产生的效果。pokeapi-pp-cli contest-effect retrieve— 华丽大赛效果指招式在华丽大赛中使用时产生的效果。
contest-type — 管理华丽大赛类型
pokeapi-pp-cli contest-type list— 华丽大赛类型是评审员在华丽大赛中衡量宝可梦状态的类别。查看……pokeapi-pp-cli contest-type retrieve— 华丽大赛类型是评审员在华丽大赛中衡量宝可梦状态的类别。查看……
egg-group — 管理蛋群
pokeapi-pp-cli egg-group list— 蛋群是用于确定哪些宝可梦能够繁殖的类别。宝可梦可以属于一个……pokeapi-pp-cli egg-group retrieve— 蛋群是用于确定哪些宝可梦能够繁殖的类别。宝可梦可以属于一个……
encounter-condition — 管理遭遇条件
pokeapi-pp-cli encounter-condition list— 影响野生宝可梦出现情况的条件，例如白天或夜晚。pokeapi-pp-cli encounter-condition retrieve— 影响野生宝可梦出现情况的条件，例如白天或夜晚。
encounter-condition-value — 管理遭遇条件值
pokeapi-pp-cli encounter-condition-value list— 遭遇条件值是遭遇条件可能具有的各种状态，例如一天中的时段可以是……pokeapi-pp-cli encounter-condition-value retrieve— 遭遇条件值是遭遇条件可能具有的各种状态，例如一天中的时段可以是……
encounter-method — 管理遭遇方式
pokeapi-pp-cli encounter-method list— 玩家在野外遭遇宝可梦的方式，例如在高草丛中行走。查看……pokeapi-pp-cli encounter-method retrieve— 玩家在野外遭遇宝可梦的方式，例如在高草丛中行走。查看……
evolution-chain — 管理进化链
pokeapi-pp-cli evolution-chain list— 进化链本质上是家族树。它从家族中最低的阶段开始，详细说明进化……pokeapi-pp-cli evolution-chain retrieve— 进化链本质上是家族树。它从家族中最低的阶段开始，详细说明进化……
evolution-trigger — 管理进化触发条件
pokeapi-pp-cli evolution-trigger list— 进化触发条件是导致宝可梦进化的事件和条件。查看……pokeapi-pp-cli evolution-trigger retrieve— 进化触发条件是导致宝可梦进化的事件和条件。查看……
gender — 管理性别
pokeapi-pp-cli gender list— 性别在第二世代引入，用于宝可梦繁殖，也可能导致外观……pokeapi-pp-cli gender retrieve— 性别在第二世代引入，用于宝可梦繁殖，也可能导致外观……
generation — 管理世代
pokeapi-pp-cli generation list— 世代是对宝可梦游戏的分组，依据各游戏包含的宝可梦划分。每个……pokeapi-pp-cli generation retrieve— 世代是对宝可梦游戏的分组，依据各游戏包含的宝可梦划分。每个……
growth-rate — 管理成长速度
pokeapi-pp-cli growth-rate list— 成长速度是宝可梦通过经验值提升等级的快慢。查看……pokeapi-pp-cli growth-rate retrieve— 成长速度是宝可梦通过经验值提升等级的快慢。查看……
item — 道具是游戏中的物品，玩家可以拾取、放入包中，并以某种方式使用。道具有多种用途，包括治疗、强化、帮助捕捉宝可梦或进入新区域。
pokeapi-pp-cli item list— 道具是游戏中的物品，玩家可以拾取、放入包中，并以某种方式使用。道具有……pokeapi-pp-cli item retrieve— 道具是游戏中的物品，玩家可以拾取、放入包中，并以某种方式使用。道具有……
item-attribute — 管理道具属性
pokeapi-pp-cli item-attribute list— 道具属性定义道具的特定方面，例如“可在战斗中使用”或“消耗品”。pokeapi-pp-cli item-attribute retrieve— 道具属性定义道具的特定方面，例如“可在战斗中使用”或“消耗品”。
item-category — 管理道具类别
pokeapi-pp-cli item-category list— 道具类别决定道具在玩家包中的存放位置。pokeapi-pp-cli item-category retrieve— 道具类别决定道具在玩家包中的存放位置。
item-fling-effect — 管理道具投掷效果
pokeapi-pp-cli item-fling-effect list— 招式“投掷”使用不同道具时产生的各种效果。pokeapi-pp-cli item-fling-effect retrieve— 招式“投掷”使用不同道具时产生的各种效果。
item-pocket — 管理道具口袋
pokeapi-pp-cli item-pocket list— 玩家包中按类别存放道具的口袋。pokeapi-pp-cli item-pocket retrieve— 玩家包中按类别存放道具的口袋。
language — 管理语言
pokeapi-pp-cli language list— 用于翻译 API 资源信息的语言。pokeapi-pp-cli language retrieve— 用于翻译 API 资源信息的语言。
location — 游戏中可前往的地点。地点构成了区域中很大一部分，例如城市或道路。
pokeapi-pp-cli location list— 游戏中可前往的地点。地点构成了区域中很大一部分，例如城市或道路。pokeapi-pp-cli location retrieve— 游戏中可前往的地点。地点构成了区域中很大一部分，例如城市或道路。
location-area — 管理地点区域
-
pokeapi-pp-cli location-area list— 地点区域是某个区域中的分区，例如建筑或洞穴中的楼层。每个区域都有自己的一组可能…… -
pokeapi-pp-cli location-area retrieve— 地点区域是某个区域中的分区，例如建筑或洞穴中的楼层。每个区域都有自己的一组可能…… machine — Machine 是用于教会 Pokémon 招式的道具的表示形式。它们因版本而异，因此无法确定某个特定的 TM 或 HM 是否对应单个 Machine。 -
pokeapi-pp-cli machine list— Machine 是用于教会 Pokémon 招式的道具的表示形式。它们因版本而异，因此无法确定…… -
pokeapi-pp-cli machine retrieve— Machine 是用于教会 Pokémon 招式的道具的表示形式。它们因版本而异，因此无法确定……
meta — 管理元数据
pokeapi-pp-cli meta— 返回当前部署的 API 版本的元数据，包括 git 提交哈希、部署日期和标签……
move — 招式是 Pokémon 在战斗中的技能。在战斗中，Pokémon 每回合使用一个招式。有些招式（包括通过 Hidden Machine 学会的招式）也可以在战斗外使用，通常用于清除障碍或探索新区域。
pokeapi-pp-cli move list— 招式是 Pokémon 在战斗中的技能。在战斗中，Pokémon 每回合使用一个招式。有些招式（包括……pokeapi-pp-cli move retrieve— 招式是 Pokémon 在战斗中的技能。在战斗中，Pokémon 每回合使用一个招式。有些招式（包括……
move-ailment — 管理招式异常状态
pokeapi-pp-cli move-ailment list— 招式异常状态是战斗中使用招式所造成的状态。参见……pokeapi-pp-cli move-ailment retrieve— 招式异常状态是战斗中使用招式所造成的状态。参见……
move-battle-style — 管理招式对战风格
pokeapi-pp-cli move-battle-style list— 在 Battle Palace 中使用招式时的风格。参见 [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Battle_Fronti...pokeapi-pp-cli move-battle-style retrieve— 在 Battle Palace 中使用招式时的风格。参见 [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Battle_Fronti...
move-category — 管理招式类别
pokeapi-pp-cli move-category list— 对招式效果进行宽泛归类的通用类别。pokeapi-pp-cli move-category retrieve— 对招式效果进行宽泛归类的通用类别。
move-damage-class — 管理招式伤害类别
pokeapi-pp-cli move-damage-class list— 招式可以具有的伤害类别，例如物理、特殊或不造成伤害。pokeapi-pp-cli move-damage-class retrieve— 招式可以具有的伤害类别，例如物理、特殊或不造成伤害。
move-learn-method — 管理招式学习方式
pokeapi-pp-cli move-learn-method list— Pokémon 学会招式的方式。pokeapi-pp-cli move-learn-method retrieve— Pokémon 学会招式的方式。
move-target — 管理招式目标
pokeapi-pp-cli move-target list— 战斗中招式可以指定的目标。目标可以是 Pokémon、环境，甚至是其他招式。pokeapi-pp-cli move-target retrieve— 战斗中招式可以指定的目标。目标可以是 Pokémon、环境，甚至是其他招式。
nature — 管理性格
pokeapi-pp-cli nature list— 性格会影响 Pokémon 能力值的成长。参见 Bulbapedia……pokeapi-pp-cli nature retrieve— 性格会影响 Pokémon 能力值的成长。参见 Bulbapedia……
pal-park-area — 管理伙伴公园区域
pokeapi-pp-cli pal-park-area list— 用于划分伙伴公园中 Pokémon 遭遇区域的区域。它们类似于伙伴公园专属的栖息地。pokeapi-pp-cli pal-park-area retrieve— 用于划分伙伴公园中 Pokémon 遭遇区域的区域。它们类似于伙伴公园专属的栖息地。
pokeathlon-stat — 管理宝可全能竞技赛能力值
pokeapi-pp-cli pokeathlon-stat list— 肯泰罗运动会属性是宝可梦在肯泰罗运动会中表现的不同属性。在肯泰罗运动会中，竞赛……pokeapi-pp-cli pokeathlon-stat retrieve— 肯泰罗运动会属性是宝可梦在肯泰罗运动会中表现的不同属性。在肯泰罗运动会中，竞赛……
pokedex — 管理图鉴
pokeapi-pp-cli pokedex list— 宝可梦图鉴是一种手持电子百科设备，能够记录和保存信息……pokeapi-pp-cli pokedex retrieve— 宝可梦图鉴是一种手持电子百科设备，能够记录和保存信息……
pokemon — 宝可梦是栖息在宝可梦游戏世界中的生物。它们可以用精灵球捕获，并通过与其他宝可梦战斗来训练。每只宝可梦都属于某个特定物种，但也可能具有不同的形态，因此与同一物种的其他宝可梦有所区别，例如基础属性、可用特性和属性类型。详情请参阅 Bulbapedia。
pokeapi-pp-cli pokemon list— 宝可梦是栖息在宝可梦游戏世界中的生物。它们可以用精灵球捕获，并……pokeapi-pp-cli pokemon retrieve— 宝可梦是栖息在宝可梦游戏世界中的生物。它们可以用精灵球捕获，并……
pokemon-color — 管理宝可梦颜色
pokeapi-pp-cli pokemon-color list— 用于在宝可梦图鉴中对宝可梦进行分类的颜色。图鉴中列出的颜色通常是最明显的颜色……pokeapi-pp-cli pokemon-color retrieve— 用于在宝可梦图鉴中对宝可梦进行分类的颜色。图鉴中列出的颜色通常是最明显的颜色……
pokemon-form — 管理宝可梦形态
pokeapi-pp-cli pokemon-form list— 某些宝可梦可能会有多种外观不同的形态。这些差异纯粹是外观上的。例如……pokeapi-pp-cli pokemon-form retrieve— 某些宝可梦可能会有多种外观不同的形态。这些差异纯粹是外观上的。例如……
pokemon-habitat — 管理宝可梦栖息地
pokeapi-pp-cli pokemon-habitat list— 栖息地通常是宝可梦可以找到的不同地形，也可能是为稀有宝可梦指定的区域……pokeapi-pp-cli pokemon-habitat retrieve— 栖息地通常是宝可梦可以找到的不同地形，也可能是为稀有宝可梦指定的区域……
pokemon-shape — 管理宝可梦外形
pokeapi-pp-cli pokemon-shape list— 用于在宝可梦图鉴中对宝可梦进行分类的外形。pokeapi-pp-cli pokemon-shape retrieve— 用于在宝可梦图鉴中对宝可梦进行分类的外形。
pokemon-species — 管理宝可梦物种
pokeapi-pp-cli pokemon-species list— 宝可梦物种是至少一种宝可梦的基础。某个宝可梦物种的属性由其所有……pokeapi-pp-cli pokemon-species retrieve— 宝可梦物种是至少一种宝可梦的基础。某个宝可梦物种的属性由其所有……
region — 管理地区
pokeapi-pp-cli region list— 地区是宝可梦世界中经过划分的区域。地区之间最主要的区别通常是其宝可梦物种……pokeapi-pp-cli region retrieve— 地区是宝可梦世界中经过划分的区域。地区之间最主要的区别通常是其宝可梦物种……
stat — 管理属性
pokeapi-pp-cli stat list— 属性决定战斗中的某些方面。每只宝可梦的每项属性都有一个数值，随着等级提升而增长……pokeapi-pp-cli stat retrieve— 属性决定战斗中的某些方面。每只宝可梦的每项属性都有一个数值，随着等级提升而增长……
super-contest-effect — 管理华丽大赛效果
pokeapi-pp-cli super-contest-effect list— 华丽大赛效果指招式在华丽大赛中使用时产生的效果。pokeapi-pp-cli super-contest-effect retrieve— 华丽大赛效果指招式在华丽大赛中使用时产生的效果。
type — 管理属性
pokeapi-pp-cli type list— 属性是 Pokémon 及其招式的特性。每种属性有三项特性：它对哪些 Pokémon 属性……pokeapi-pp-cli type retrieve— 属性是 Pokémon 及其招式的特性。每种属性有三项特性：它对哪些 Pokémon 属性……
version — 管理版本
pokeapi-pp-cli version game-list— 游戏版本，例如 Red、Blue 或 Yellow。pokeapi-pp-cli version game-retrieve— 游戏版本，例如 Red、Blue 或 Yellow。
version-group — 管理版本组
pokeapi-pp-cli version-group list— 版本组用于归类高度相似的游戏版本。pokeapi-pp-cli version-group retrieve— 版本组用于归类高度相似的游戏版本。
查找合适的命令
当你知道要做什么，却不知道哪个命令能做到时，可以直接向 CLI 提问：
pokeapi-pp-cli which "<capability in your own words>"
which 会根据自然语言能力查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一项匹配；退出代码 2 表示没有有把握的匹配项——请改用 --help，或缩小查询范围。
示例
我的队伍有哪些弱点？
pokeapi-pp-cli team gaps pikachu,charizard,blastoise --json
返回队伍既没有抗性、也没有克制手段的所有属性。只需一次本地联查。
按效果反向搜索
pokeapi-pp-cli move find --effect paralyze --type-target steel --json --select name,type,power,accuracy
查找能命中钢属性的麻痹招式——使用 --select 缩小响应范围，减少 Agent 上下文占用。
将档案缩减到 Agent 所需的内容
pokeapi-pp-cli pokemon profile pikachu --json --select name,types,stats.hp,stats.attack,abilities
使用 --select 和点分路径，从深层嵌套的响应中提取重要字段，让 Agent 上下文保持精简。
比较两种地区形态
pokeapi-pp-cli pokemon diff-learnset vulpix vulpix-alola --json
并排比较 Vulpix 和 Alolan Vulpix 的可学招式差异。只需一次本地查询，而非两次完整 API 获取。
使用 SQL 自定义联查
pokeapi-pp-cli sql "SELECT id FROM resources WHERE resource_type='pokemon-species' ORDER BY id LIMIT 10" --json
没有专用命令时，可直接使用原始 SQL——只读访问本地存储。
身份验证设置
无需身份验证。
运行 pokeapi-pp-cli doctor 验证设置。
Agent 模式
在任意命令中添加 --agent，相当于展开为：--json --compact --no-input --no-color --yes。
-
可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr
-
可筛选 —
--select可保留部分字段。点分路径可深入嵌套结构；数组会逐项遍历。对于响应冗长的 API，这对精简上下文至关重要：pokeapi-pp-cli ability list --agent --select id,name,status -
可预览 —
--dry-run会显示请求，但不会发送 -
支持离线 — 有本地 SQLite 存储时，同步／搜索命令可以使用它
-
非交互式 — 从不提示输入，所有输入均通过标志提供
-
只读 — 请勿使用此 CLI 执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送或其他会修改数据的请求
响应封装
从本地存储或 API 读取数据的命令会将输出封装在一个来源信息对象中：
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
解析 .results 获取数据，并查看 .meta.source 确认数据来自实时 API 还是本地存储。只有当 stdout 连接到终端时，才会将人类可读的 N results (live) 摘要输出到 stderr；通过管道接收的程序或 Agent 会在 stdout 获取纯 JSON。
Agent 反馈
当你（或 Agent）发现此 CLI 有任何不妥之处时，请记录下来：
pokeapi-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
pokeapi-pp-cli feedback --stdin < notes.txt
pokeapi-pp-cli feedback list --json --limit 10
记录会保存在本地 ~/.pokeapi-pp-cli/feedback.jsonl。除非设置了 POKEAPI_FEEDBACK_ENDPOINT，并且传入 --send 或设置 POKEAPI_FEEDBACK_AUTO_SEND=true，否则绝不会通过 POST 发送。默认情况下，记录仅保存在本地。
写下让你感到意外的地方，而不是提交 Bug 报告。简短、具体、一行即可：点滴反馈会不断累积。
输出传递
每条命令都接受 --deliver <sink>。除了标准输出（或替代标准输出）之外，输出还会发送到指定的接收端，因此 Agent 可以路由命令结果，而无需手动通过管道传递。支持三种接收端：
| 接收端 | 效果 |
|---|---|
stdout | 默认；仅写入标准输出 |
file:<path> | 以原子方式将输出写入 <path>（临时文件 + 重命名） |
webhook:<url> | 将输出正文 POST 到该 URL（使用 --compact 时为 application/json 或 application/x-ndjson） |
对于未知方案，系统会拒绝请求并返回结构化错误，指出支持的方案。Webhook 请求失败时会返回非零状态，并在标准错误中记录 URL 和 HTTP 状态码。
命名配置
配置是保存的一组标志值，可在多次调用中重复使用。如果计划运行的 Agent 每次都使用相同配置调用同一条命令，请使用配置——这是 HeyGen 的“Beacon”模式。
pokeapi-pp-cli profile save briefing --json
pokeapi-pp-cli --profile briefing ability list
pokeapi-pp-cli profile list --json
pokeapi-pp-cli profile show briefing
pokeapi-pp-cli profile delete briefing --yes
显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，以便 Agent 在运行时发现这些配置。
退出代码
| 代码 | 含义 |
|---|---|
| 0 | 成功 |
| 2 | 用法错误（参数错误） |
| 3 | 未找到资源 |
| 5 | API 错误（上游问题） |
| 7 | 速率受限（等待后重试） |
| 10 | 配置错误 |
参数解析
解析 $ARGUMENTS：
- 为空、
help或--help→ 显示pokeapi-pp-cli --help输出 - 以
install开头 → 以mcp结尾 → 安装 MCP；否则 → 参见上方的先决条件 - 其他任何内容 → 直接使用（作为带有
--agent的 CLI 命令执行）
MCP 服务安装
- 安装 MCP 服务：
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/pokeapi/cmd/pokeapi-pp-mcp@latest - 在 Claude Code 中注册：
claude mcp add pokeapi-pp-mcp -- pokeapi-pp-mcp - 验证：
claude mcp list
直接使用
- 检查是否已安装：
which pokeapi-pp-cli如果未找到，请提供安装选项（参见本技能顶部的先决条件）。 - 根据用户查询，从上方的独特功能和命令参考中选择最合适的命令。
- 使用
--agent标志执行：pokeapi-pp-cli <command> [subcommand] [args] --agent - 如果存在歧义，请查看子命令帮助：
pokeapi-pp-cli <command> --help。