万年历查询

解决什么问题

排期、合同评审、日志归档这类场景里，经常要确认「某天是星期几」「农历几月几号」「当天宜忌如何」「是否法定节假日」。在日历 App 和网页之间来回切，结果还得手工拼装，既慢又容易出错；跨阴阳历时还得先判断是不是闰月。这个 Skill 把这类查询收敛成一次结构化调用：给一个日期，拿回星期、星座、农历、生肖、干支、黄历宜忌、节假日状态与周次。

核心能力

• 指定日期全字段查询：date 使用 年/月/日 格式，例如 2024/1/15，返回星期、星座、农历年月日、干支、生肖。
• 阴阳历转换：islunar 决定输入是阴历还是阳历，islunarmonth 标记是否闰月。
• 黄历信息：result.huangli.yi / result.huangli.ji 分别给出宜、忌列表。
• 节假日与周次：workholiday 标注是否法定休息，weeknum 给出第几周。
• 状态判断：先读 status 与 msg，status 为 0 才算查询成功。

调用流程与失败处理

1. 从用户输入中抽取 date、islunar、islunarmonth，一次只查一个目标。
2. 在 Skill 根目录执行 python scripts/query_wannianli.py --date 2024/1/15，必要时追加 --api-key；若环境变量 CHINAZ_WANNIANLI_API_KEY 已配置，可省略该参数。
3. 脚本调用万年历接口，从输出 JSON 的 result 中读取数据后再组织答复，不凭空补字段。

常见失败：missing_api_key 时引导用户前往购买页获取专属 Key 并直接发给 AI；invalid_input 时检查日期格式；网络类错误先确认代理与防火墙再重试。Key 无效或额度耗尽时，提示前往购买页核对。

注意点

• 该 Skill 只覆盖万年历查询，不用于其他日历类功能。
• 批量需求必须逐条执行，不能一次传多个日期。
• 返回结果仅供参考，不具备法律效力。
• API Key 只用于当次请求，不输出、不复述、不落盘。
• 若系统把 Python 3 命令命名为 python3，用 python3 替换 python。