Use when users ask for 老黄历/黄历/择日/宜忌/冲煞/干支/节气 explanations, or need a reproducible engineering workflow to compute calendar fields and derive traditional almanac recommendations.
当用户出现以下需求时启用：
老黄历、黄历、万年历、宜忌、择日、通胜、冲煞、彭祖百忌、建除十二神、黄道吉日GB/T 33661-2017《农历的编算和颁行》 为准，负责农历、节气、朔望、闰月、干支。《钦定协纪辨方书》 为准，负责建除、黄黑道、神煞、冲煞、胎神、彭祖百忌和宜忌裁决。《钦定协纪辨方书》 中结构化落盘，可使用其他可追溯古籍补充，但必须在 provenance.sourceRefs 中逐项显式标明，不得冒称为协纪辨方书原文。输入标准化
基础历法计算（确定性）
干支计算（确定性）
黄历神煞/值日体系（规则表）
ruleset: zh-traditional-v1）。宜忌生成（规则引擎）
可解释输出
优先使用脚本计算“可精算字段”，不要直接凭网页汇总给结论。
skills/lao-huangli/scripts/huangli 2026 3 2 12 --profile market-folk-v1 --format calendar
skills/lao-huangli/scripts/huangli 2026 3 2 12 --profile xiejibianfang-v1 --format json
skills/lao-huangli/scripts/huangli 2026 3 2 23 --profile bazi-v1 --format calendar
skills/lao-huangli/scripts/huangli 2026 3 2 23 --profile bazi-v1 --overlay-ruleset xiejibianfang-v1 --format json
脚本产出保证：
当前脚本支持三种 profile：
market-folk-v1：春节换年 + 00:00 换日（更贴近大众挂历）xiejibianfang-v1：春节换年 + 00:00 换日（规则来源预留为《协纪辨方书》体系）bazi-v1：立春换年 + 23:00 换日（更贴近八字排盘）默认直接查询时，优先按 market-folk-v1 输出，效果更接近常见挂历版老黄历。
兼容说明：
--mode market|bazi--profile脚本不会伪造：
推荐直接运行（无需本地安装依赖）：
skills/lao-huangli/scripts/huangli 2026 3 9 12 --profile market-folk-v1 --format markdown
如需本地固定环境，再手动安装依赖：
uv venv .venv
uv pip install --python .venv/bin/python -r skills/lao-huangli/requirements.txt
当前实现状态：
calendar_core 与 rule_engine 模块骨架已建立meta 已输出 profileId、profileLabel、边界信息、ruleLayer、overlayRulesetxiejibianfang-v1 与 market-folk-v1 已输出可用的 daily/decisiondaily 已稳定承载 jianchu、yellowBlackDao、dutyGod、goodStars、badStars、chongsha、taishen、pengzuxiejibianfang-v1 的 宜/忌 已覆盖 建/除/满/平/定/执/破/危/成/收/开/闭 的一批卷十直引条目market-folk-v1 已补齐常用 冲煞、胎神、彭祖百忌，并沿用同一批高频 建除 宜忌收口market-folk-v1 已补齐常用 财神 / 喜神 / 福神 方位bazi-v1 默认只输出 bazi-core，如指定 --overlay-ruleset 则输出 hybrid 黄历层provenance 已输出 ruleLayer、ruleSourceLevel、sourceRefs、isHybridSkyfield + JPL ephemeris 的天文时刻窗口输出，并带 currentAt / nextAtsolar_terms 现已提供 table、currentJie、currentQi、nextJie、nextQi，便于后续按 6tail 风格继续派生字段lunar 现已提供 monthStartDate、monthEndDate、monthDayCount、leapMonth、zhongQi、containsZhongQi、anchorYear、yearMonthTable、yearMonthCount、yearLeapMonth、currentMonthIndex、calculationModeGB/T 33661-2017 口径规则来源约束：
sourceLevelsourceRefxiejibianfang-v1 当前混合 L1-primary 与 L2-derived-documentedmarket-folk-v1 目前使用 L2-derived-documented / L3-market-observed 混合标记默认输出采用“挂历完整版”（正常版本），只有用户明确要求“简版/速览”时才降级精简。 下面只示意版式，不表示某个真实日期的计算结果。
┌────────────────────────────────────────────────────────────┐
│ YYYY年MM月DD日 星期X │
│ 农历：二〇二六年 正月十四（闰月：否） │
│ 干支：年柱 / 月柱 / 日柱（时柱按用户时刻另算） │
│ 节气：当前 节气A → 下个 节气B │
├────────────────────────────────────────────────────────────┤
│ 【宜】出行 会友 祭祀 祈福 纳财 │
│ 【忌】动土 开仓 破屋 │
├────────────────────────────────────────────────────────────┤
│ 建除十二神：定日 黄黑道：黄道日 值神：天德 │
│ 冲煞：冲鸡(乙酉)煞西 生肖冲合：鸡冲 / 狗合 / 猪三合 │
│ 胎神：仓库门外正南 彭祖百忌：丁不剃头，卯不穿井 │
│ 吉神宜趋：天德、月德、天恩 凶神宜忌：五虚、土符 │
│ 财神：正西 喜神：正南 福神：西北 │
├────────────────────────────────────────────────────────────┤
│ 时辰吉凶（示例） │
│ 子时 23:00-00:59 吉 宜：祈福/求财 忌：动土 │
│ 丑时 01:00-02:59 凶 宜：静守 忌：远行/开市 │
│ 寅时 03:00-04:59 吉 宜：出行/见贵 忌：争讼 │
│ ...（其余时辰按同样结构列出） │
└────────────────────────────────────────────────────────────┘
说明：历法/干支/节气为可精算；宜忌/神煞依赖 rulesetVersion=zh-traditional-v1
【宜】 与 【忌】（宜在前）【宜】 与 【忌】 必须分行且“宜在前”待规则库补齐，不可静默忽略rulesetVersion用户：帮我看 2026-03-02 的老黄历，为什么今天宜出行？
回答结构建议：
references/calculation-pipeline.mdreferences/rules-and-variants.mdscripts/huangli_calc.py