harrypotter

Harry Potter Lookup 是一款专为AI Agent设计的命令行工具，旨在帮助用户快速查询哈利波特魔法世界的各类信息。该技能通过调用免费的HP-API（hp-api.onrender.com），无需任何认证即可获取角色档案、学院成员、魔法咒语等丰富内容，让AI助手能够即时回答"谁是格兰芬多的成员"或"哈利波特中有哪些咒语"等问题。

核心用法

该技能提供六种主要查询模式：获取全部角色列表（支持数量限制）、仅查询学生或教职工、按学院筛选（格兰芬多、斯莱特林、拉文克劳、赫奇帕奇）、获取魔法咒语清单，以及通过关键词搜索特定角色。输出结果采用友好的格式化展示，包含角色所属学院、血统、守护神等详细信息，搜索模式还会展示演员、魔杖规格和出生日期等扩展内容。

显著优点

首先，零门槛使用是该技能的最大亮点——无需注册账号或申请API密钥，开箱即用。其次，输出设计极具亲和力，使用🧙和✨等emoji增强可读性，提升用户体验。功能覆盖全面，从基础的角色查询到详细的魔杖信息都能一站式获取。技术实现简洁高效，仅依赖标准的bash、curl和jq工具，兼容性强。对于构建娱乐型AI助手或哈利波特主题应用而言，这是即插即用的理想组件。

潜在局限

该技能的主要限制在于对外部API的强依赖——hp-api.onrender.com的服务可用性、响应速度和数据更新频率完全由第三方控制，存在服务中断风险。默认的20条查询限制在处理大规模数据时可能不够灵活。此外，功能边界严格限定于哈利波特宇宙，无法扩展至其他奇幻作品。网络依赖性也意味着离线环境无法使用。

适用人群

本技能特别适合以下场景：构建哈利波特主题的聊天机器人或虚拟助手、需要快速验证魔法世界设定的内容创作者、开发娱乐类应用的开发者，以及希望通过AI助手获得即时魔法世界信息的普通粉丝。对于教育场景中的文学讨论或创意写作辅助也有一定价值。

风险提示

使用过程中需注意：由于数据来源为第三方公共API，建议避免在处理敏感或隐私要求高的场景中使用；网络请求可能产生延迟，高频调用需考虑API速率限制；作为T3级个人开发者作品，长期维护更新存在不确定性。建议在生产环境中实施适当的错误处理和降级机制，以应对API服务异常的情况。

核心用法

本 Skill 为 AI 代理提供哈利波特宇宙信息查询能力，通过调用公开 HP-API（hp-api.onrender.com）实现角色检索、学院分类、咒语查询等功能。用户可通过自然语言指令（如"格兰芬多有哪些人""列出哈利波特咒语"）触发查询，Agent 会自动调用对应命令获取结构化数据。

主要命令：

• harrypotter characters [limit] — 获取角色列表
• harrypotter house <name> — 按学院筛选（gryffindor/slytherin/hufflepuff/ravenclaw）
• harrypotter spells [limit] — 查询魔法咒语
• harrypotter search <query> — 按名称搜索角色
• harrypotter students/staff — 区分学生与教职人员

显著优点

1. 零门槛使用：无需注册账号或 API 密钥，即开即用
2. 输出友好：格式化结果带 emoji 标识（🧙角色/✨咒语），含学院血统、魔杖材质、演员信息等丰富字段
3. 纯文档安全架构：T-MD 纯 Markdown 实现，无本地代码执行，依赖系统基础工具（bash/curl/jq）
4. 隐私合规：不收集敏感数据，符合 GDPR/CCPA 要求
5. 场景适配：天然适合对话式 AI 场景，可直接响应用户娱乐问答需求

潜在缺点与局限性

1. 外部服务依赖：HP-API 为第三方免费服务，存在可用性风险（维护、下线、响应延迟），无 SLA 保障
2. 数据时效性有限：API 数据基于原著设定，不包含《哈利波特与被诅咒的孩子》等新作品或 Pottermore 扩展内容
3. 查询深度受限：不支持复杂条件组合（如"同时会飞行咒的格兰芬多学生"），需多次调用客户端过滤
4. 无本地化缓存：每次查询均实时请求 API，高频场景可能触发速率限制或增加延迟

适合人群

• 哈利波特爱好者：快速查证角色关系、学院归属、咒语效果
• 内容创作者：撰写同人文、制作知识问答内容时的素材查询
• AI 应用开发者：为聊天机器人集成娱乐百科能力的轻量方案

常规风险

• 服务可用性：API 离线时功能完全失效，建议添加超时处理（推荐 10-15 秒）
• 数据完整性：API 返回格式变更可能导致解析失败，需做好异常兜底
• 文档描述偏差：SKILL.md 提及的脚本路径与实际纯文档结构不符，实际通过系统 curl 命令调用

安全评级依据：CLS-Certify v2.1.0 综合评分 88/100，静态分析 95 分，无恶意代码、无敏感信息泄露、供应链攻击面极小。