老黄历计算技能（Lao Huangli）
name: lao-huangli
by cikichen · published 2026-03-22
$ claw add gh:cikichen/cikichen-lao-huangli---
name: lao-huangli
description: Use when users ask for 老黄历/黄历/择日/宜忌/冲煞/干支/节气 explanations, or need a reproducible engineering workflow to compute calendar fields and derive traditional almanac recommendations.
license: MIT
metadata:
clawdbot:
requires:
bins:
- python3
- uv
---
# 老黄历计算技能（Lao Huangli）
何时使用
当用户出现以下需求时启用：
核心原则
1. **先算历法，再套规则**：先得到可靠的天文/历法基础字段，再生成宜忌。
2. **区分“确定性”与“流派性”**：节气、干支、农历可精确计算；宜忌、吉凶级别常依赖规则库。
3. **必须可追溯**：输出时明确计算边界、时区、采用的规则版本。
双原典边界
计算总流程（工程化）
1. **输入标准化**
- 输入：公历日期时间、时区（默认 Asia/Shanghai）、可选地点。
- 约束：明确“日界”规则（通常以 23:00 子初或 00:00 作为换日点，需在输出声明）。
2. **基础历法计算（确定性）**
- 公历 → 儒略日（JDN）
- 计算当年 24 节气时刻（太阳黄经每 15°）
- 计算朔望（新月）序列，确定农历月、闰月、月日
3. **干支计算（确定性）**
- 年柱：以立春或春节为界（系统需固定一种并声明）
- 月柱：以节气月为界（寅月起）
- 日柱：基于 JDN 与甲子基准日取模 60
- 时柱：由日干 + 时支映射得到
4. **黄历神煞/值日体系（规则表）**
- 建除十二神、黄黑道、值神、吉神凶煞等，通常来自规则映射表。
- 规则表需版本化（如 `ruleset: zh-traditional-v1`）。
5. **宜忌生成（规则引擎）**
- 输入：干支、节气、建除、神煞、冲煞、月令。
- 处理：
- 候选事项打分（嫁娶、开市、动土、出行等）
- 冲突裁决（优先级规则）
- 输出宜/忌/次吉，并附理由。
6. **可解释输出**
- 输出字段：公历、农历、干支四柱、节气、值神、建除、冲煞、胎神、彭祖百忌、宜忌。
- 附“计算说明”：哪些是天文历法精算，哪些来自流派规则。
精确计算 vs 规则依赖
对话执行模板
1. 先确认日期时间与时区。
2. 给出历法基础结果（农历 + 干支 + 节气）。
3. 再给宜忌结果，并说明规则来源。
4. 明确风险提示：黄历建议仅作文化参考，不替代法律、医疗、财务和安全决策。
计算执行（脚本优先）
优先使用脚本计算“可精算字段”，不要直接凭网页汇总给结论。
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` 输出，效果更接近常见挂历版老黄历。
兼容说明：
脚本不会伪造：
推荐直接运行（无需本地安装依赖）：
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当前实现状态：
规则来源约束：
输出格式（仿挂历，默认详细版）
默认输出采用“**挂历完整版**”（正常版本），只有用户明确要求“简版/速览”时才降级精简。
下面只示意版式，不表示某个真实日期的计算结果。
┌────────────────────────────────────────────────────────────┐
│ YYYY年MM月DD日 星期X │
│ 农历：二〇二六年 正月十四（闰月：否） │
│ 干支：年柱 / 月柱 / 日柱（时柱按用户时刻另算） │
│ 节气：当前 节气A → 下个 节气B │
├────────────────────────────────────────────────────────────┤
│ 【宜】出行 会友 祭祀 祈福 纳财 │
│ 【忌】动土 开仓 破屋 │
├────────────────────────────────────────────────────────────┤
│ 建除十二神：定日 黄黑道：黄道日 值神：天德 │
│ 冲煞：冲鸡(乙酉)煞西 生肖冲合：鸡冲 / 狗合 / 猪三合 │
│ 胎神：仓库门外正南 彭祖百忌：丁不剃头，卯不穿井 │
│ 吉神宜趋：天德、月德、天恩 凶神宜忌：五虚、土符 │
│ 财神：正西 喜神：正南 福神：西北 │
├────────────────────────────────────────────────────────────┤
│ 时辰吉凶（示例） │
│ 子时 23:00-00:59 吉 宜：祈福/求财 忌：动土 │
│ 丑时 01:00-02:59 凶 宜：静守 忌：远行/开市 │
│ 寅时 03:00-04:59 吉 宜：出行/见贵 忌：争讼 │
│ ...（其余时辰按同样结构列出） │
└────────────────────────────────────────────────────────────┘
说明：历法/干支/节气为可精算；宜忌/神煞依赖 rulesetVersion=zh-traditional-v1字段顺序（固定）
1. 顶部主栏：公历日期 + 星期
2. 历法层：农历（含闰月）、干支、节气（当前/下个与时刻）
3. 宜忌层：`【宜】` 与 `【忌】`（宜在前）
4. 日神层：建除、黄黑道、值神、冲煞、胎神、彭祖百忌、吉神凶煞
5. 方位层：财神/喜神/福神
6. 时辰层：12 时辰吉凶（每行含时间段、吉凶、宜忌）
7. 末尾说明：规则版本与边界（年界/日界）
模式规则
排版规则
- 可精算字段（农历/干支/节气）
- 规则字段（宜忌/神煞）与 `rulesetVersion`
示例
用户：`帮我看 2026-03-02 的老黄历，为什么今天宜出行？`
回答结构建议：
1. 历法层：公历/农历/干支/节气
2. 规则层：建除/值神/冲煞
3. 结论层：宜出行的规则依据 + 忌事项 + 边界说明
按需阅读
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...