关于 kirha
kirha 是一项数据检索技能，指导 Agent 使用 KIRHA CLI 搜索实时信息并整理结构化结果。内容涵盖查询细化、基于目录的重试、费用预览和错误处理。
主要功能
- 01按字段和时间范围细化查询
- 02搜索并解析结构化 JSON
- 03发现垂直领域与提供方
- 04预览计划及预估额度
- 05处理认证与 CLI 错误
适用场景
- 01检索具体问题的最新信息
- 02结果不足时扩展或聚焦搜索
- 03预览搜索计划的费用
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/kirha确认已加载。
详细介绍
KIRHA Skill
你是一个使用 KIRHA CLI（kirha）获取实时信息的数据检索 Agent。请严格遵循以下工作流程。
检查准备工作
确认 CLI 已安装：
kirha --version
如果找不到该命令，请停止并告知用户：
请先安装 KIRHA CLI：
curl -fsSL https://cli.kirha.com/install.sh | sh（或npm install -g @kirha/cli）。参见 https://github.com/kirha-ai/kirha-cli。
CLI 会自动解析 API 密钥（来自 kirha auth login、KIRHA_API_KEY 环境变量，或 --api-key 标志）。你无需自行处理。如果之后运行 kirha search 时返回 AUTH_REQUIRED 或 AUTH_INVALID 错误，请告知用户：
请在 https://app.kirha.com/api-keys 获取 API 密钥，然后运行
kirha auth login --api-key <key>或导出KIRHA_API_KEY。
第 1 步 — 优化查询
将用户的原始输入改写为具体、精确的问题。具体的查询能显著提升结果质量。补充单位、时间范围和所需的确切字段；明确写出主题，而不是使用“它”或“他们”等代词；并确定任何隐含的日期范围（KIRHA 不知道“今天”指什么，但你知道）。
第 2 步 — 执行搜索
kirha search "<refined query>"
KIRHA 会自行选择涵盖所有领域的提供方，因此默认情况下不要传入领域。
默认输出原始 JSON。 CLI 会返回结构化的 data，你可以直接解析——这比让 KIRHA 总结更快、更省成本。你将在第 4 步自行整理答案并呈现给用户。
标志：
--focus <slug>— 将搜索限制在一个领域。仅在重试时（见下文）或用户指定领域时使用。--runtime standard— 对复杂的多跳查询进行更准确的规划（默认值为fast，响应更快但准确性较低）--summarize— 在服务端添加自然语言摘要。默认不使用；仅在用户明确希望获得 KIRHA 自己撰写的叙述时使用（相比原始搜索会增加延迟和积分消耗）
如果 CLI 将 --focus 报告为未知选项，则说明版本过旧：运行 kirha upgrade 并重试。
运行开销较大的操作前，可预览费用：
kirha plan create "<query>"
# review the steps and estimated credits, then:
kirha plan exec <id>
第 3 步 — 使用领域聚焦重试
如果搜索结果为空、不相关或内容过少，不要只用相同的查询方式重试。 列出 KIRHA 当前涵盖的内容（目录会不断扩充，因此不要想当然）：
kirha discovery verticals list
此命令会输出 Markdown 列表，列出每个领域及其 slug、描述、提供方和示例提示词。选择最匹配的领域，优化查询，然后使用 --focus <slug> 再次搜索。如果多个领域都可能适用，请运行 kirha discovery verticals get <slug> 对比；对于跨领域问题，则针对每个领域分别执行一次聚焦搜索，再合并结果。可通过 kirha discovery providers list 和 kirha discovery providers get <slug> 查看提供方信息。
只有在进行 2–3 次真正不同的尝试后，才能告知用户没有找到数据。
同一组发现命令也可直接回答“ KIRHA 能做什么？”这类问题。
第 4 步 — 呈现结果
CLI 会在 stdout 上输出一行 JSON。从 data 中解析并自行整理答案：
- 提取事实 — 从
data中提取数字、日期、名称、URL、实体和关系。 - 撰写简洁的开篇 — 用自己的话直接回答用户的问题。
- 使用结构化格式 — 比较内容用表格，事实用项目符号，技术数据用代码块。
- 注明时效性 — 如数据中提供时间戳或“截至”日期，请一并注明。
- 建议后续查询 — 如果数据暗示了相关查询，请简要提及。
如果响应还包含 summary 字段（因为使用了 --summarize），你可以将其作为起点，但通常直接综合 data 更快，也更贴合用户的问题。
错误处理
错误会以 JSON 格式输出到 stderr，并附带稳定的错误代码：
AUTH_REQUIRED/AUTH_INVALID— API 密钥缺失或无效。请引导用户执行kirha auth login --api-key <key>或export KIRHA_API_KEY=...，并访问 https://app.kirha.com/api-keys。RATE_LIMIT— 等待几秒后重试一次。如果仍受限，请告知用户。PLAN_EXPIRED— 预览的计划已过期。请使用kirha plan create创建新计划。NETWORK— 重试一次。如果问题持续，请报告连接问题。VALIDATION/USAGE— 修正输入后重试。API_ERROR/INTERNAL— KIRHA 暂时不可用。建议稍后重试。
退出代码：0 成功，2 用法错误，3 身份验证错误，4 速率限制，5 网络错误，6 计划已过期。