Agent Skills
返回列表
黄历查询

黄历查询

生活服务 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据官方指南 https://skillhub.cn/install/skillhub.md，将 @org-1qazsc77/huangli-query 技能安装到当前 AI 助手中。

技能介绍

要解决的问题

在需要农历转换、择吉日或传统文化数据查询的场景中，开发者通常得自己对接多个数据源、处理农历计算逻辑、维护日期映射表，而且数据准确性难以保证。尤其涉及胎神、吉神方位这类细分字段时，自行实现的工作量不小。

技能如何工作

这个技能封装了黄历查询接口，按年月日三个参数返回完整的黄历数据。核心能力包括：

  • 覆盖范围广：数据范围 1900–2100 年，满足大多数历史查询和未来择日需求
  • 字段完整：返回农历、星座、生肖、五行、冲煞、宜忌、吉神方位、值日天神等传统黄历要素
  • 按需查询：一次请求对应一个目标日期，避免批量操作带来的状态管理复杂度

使用流程很简单：用户准备好 year、month、day 三个参数，技能脚本会调用接口获取结果，从返回的 JSON 中提取所需字段呈现给用户。如果未配置 API Key，会引导用户前往购买页获取；Key 无效或额度不足时也有明确的失败处理路径。

适用边界与注意点

  • 单次单查：接口一次只处理一个日期，批量需求需逐条执行后自行汇总
  • 数据性质：黄历数据仅供参考，不作为法律或正式决策依据
  • 密钥安全：API Key 仅用于当前查询，不输出、不保存、不复述完整密钥
  • 网络依赖：查询结果受网络环境影响，如有异常可检查参数、Key 有效性及网络连接

使用场景

  • 婚礼或开业筹备中，需要查多个候选日期的农历与宜忌，逐一对比后定吉日
  • 根据出生公历日期反查农历日期、生肖和星座，用于个人档案记录或纪念内容制作
  • 安排清明扫墓、中秋拜月等传统活动时，查当天宜忌和冲煞方位做参考
  • 整理年度吉日参考表时，需要逐条查询全年多个日期的宜忌并汇总成清单

适合人员

  • 婚礼策划师，需要为客户对比多个候选婚期的农历宜忌，给出有传统依据的日期建议
  • 民俗文化内容创作者，在写节气民俗或生肖运势文章前需核对具体日期的农历与宜忌数据
  • 企业活动策划专员，组织开业庆典、年会等传统仪式前需要查吉日与吉神方位做参考
  • 民俗研究者，研究各地择日习俗时需要快速查询历史日期的黄历信息作为对照资料