农历日历服务

要解决什么问题

公历与农历混用、择日看黄历、排八字或查节气时，本地心算或零散网页既难对接 Agent，也容易在模型侧被「编造」成看似合理的历法结果。这个技能把历法与民俗类查询收敛成一组固定工具调用，由后端 API 返回结构化数据，模型只负责理解意图、补全参数并整理 result["raw"]。

技能如何工作

实现侧基于 Python 3.12 与 lunar-python，对外通过小笨羊服务的 API 提供能力。大模型按 SKILL 约定充当路由层：先检查 scripts.config.settings.api_key，缺失时用 AskUserQuestion 向用户索取并写入配置；再根据用户说法选择 scripts.tools 中的函数，用关键字参数调用，例如：

• calendar_convert：公历 ↔ 农历，convert_to 为 lunar 或 solar，农历转公历时可选 is_leap
• huangli_query：指定 YYYY-MM-DD 的黄历
• bazi_calculate / wuxing_analyze：出生日期与时间
• jieqi_query：按年份查二十四节气
• fortune_daily：某日运势与建议

参数不全时应追问用户，禁止在无密钥时自行搜索或捏造历法内容。

适用边界

必须配置 API 密钥（环境变量 XBY_APIKEY 或经 set_api_key 保存），密钥在 xiaobenyang.com 获取。工具返回的 success、message 与 raw 需如实转述；运势、五行等属于 API 解读结果，不等同于专业命理咨询。