技能介绍

解决什么问题

做一个排期工具时，如果需求是「看一眼今天适不适合动土」，翻纸质通书或者去搜网页截图都不现实。网上的黄历数据来源杂、字段不全：有的只给一句吉凶，没有建除和二十八宿；有的月柱按农历月算而不是按节气月建算，导致跨节气当天数据跳变。这个技能把一套可复现的通书计算逻辑封装成自然语言接口，输入日期即可返回结构化结果。

核心能力

每日查询返回五个字段：

干支：年柱、月柱、日柱。月柱以节气为准，而非农历月份
建除十二神：建除满平定执破危成收开闭 12 天循环，含释义与择日建议
二十八宿：28 宿名称、所属四象（青龙/玄武/白虎/朱雀）、五行与吉凶
彭祖百忌：内置天干 10 条、地支 12 条禁忌
冲煞：由日支推算，如子午冲、丑未冲，并标注煞向

调用方式是自然语言：查2026年6月15日的通书、今天通书怎么样，也支持农历节日，如 查2026年端午节通书。

校准与边界

计算依赖两个年度锚点，都需要每年校准：

JIANCHU_YEAR_ANCHOR：正月初一的建除起始位置，按年支推导（子/辰/申年起建，丑/巳/酉年起除，寅/午/戌年起满，卯/未/亥年起平）
ERSHUBU_YEAR_ANCHOR：二十八宿的年度起始位置

2026 年的二十八宿锚点已校准：2026-06-22 丁卯日 = 觜宿（白虎·金·凶），脚本输出验证通过；建除锚点目前按规则推导，仍需每年对照通书确认。历史修复过两个 bug：月柱偏移必须从寅月起算，不能直接用 dizhi.index 的子位零点；节气匹配改为列表遍历，保证非节气当天的日期也能命中正确月建。适用边界：输出仅作传统择日参考，不构成决策依据，也不覆盖择吉之外的择时、风水等需求。