技能介绍

解决什么问题

当你在终端里写脚本、做自动化或者调试一个聊天机器人时，突然想查一道菜的做法，通常得切到浏览器、翻食谱网站，再把结果手动抄回来。这个过程割裂了工作流，也不适合程序化处理。菜谱查询工具 就是为这个场景准备的：它把「查菜单」和「查菜品详情」两个动作收敛到一个命令行技能里，让大模型可以直接通过工具函数拿到结构化的菜品数据，而不是靠记忆现编。

核心能力与工作流程

这个技能的职责划分很明确：大模型是路由层，代码只负责调 API。模型负责理解用户意图、选择工具、提取参数；scripts/tools 里的函数负责实际的数据请求。

目前暴露两个工具函数：

get_all_dishes：获取全部可用菜品的名称列表，也就是「报菜名」这个能力背后的实现。
get_dish_content：按菜品名称查详情，例如传入 dishName='麻婆豆腐' 就能拿到对应内容。

标准流程分五步：先检查 API 密钥是否已配置；然后根据用户意图从工具表里选函数；接着提取所需参数，缺参数时通过 AskUserQuestion 追问；之后以关键字参数形式调用工具，比如 scripts.tools.get_dish_content(dishName='麻婆豆腐')；最后把返回的 raw 数据整理后展示给用户。

适用边界与注意点

这个技能有几个硬性约束，使用前值得先了解：

API 密钥是必需品。.env 中必须配置 XBY_APIKEY，否则技能不会正常工作。首次使用时如果检测不到密钥，会主动向你询问，拿到后通过 scripts.config.set_api_key(key) 保存。
禁止无密钥编造数据。缺少密钥时，技能不会退而求其次去网上搜索或凭模型知识生成菜谱，这一点在规范里被明确禁止。
工具函数返回的是包含 raw、success、message 三个键的 dict 对象，raw 是 API 的原始 JSON，需要由模型整理后再呈现。

它适合需要把菜谱查询嵌入自动化流程的开发者，或者想用自然语言对话方式查菜的烹饪爱好者；如果你需要的是营养分析、食材采购建议这类功能，这个技能并不覆盖。