lao-huangli

Files (40)

• SKILL.md
• calculation-pipeline.md · references/
• rules-and-variants.md · references/
• requirements.txt
• overlay-defaults.json · rules/bazi-v1/
• placeholder.json · rules/bazi-v1/
• bad-stars.json · rules/market-folk-v1/
• chongsha.json · rules/market-folk-v1/
• directions.json · rules/market-folk-v1/
• duty-gods.json · rules/market-folk-v1/
• good-stars.json · rules/market-folk-v1/
• jianchu.json · rules/market-folk-v1/
• pengzu.json · rules/market-folk-v1/
• placeholder.json · rules/market-folk-v1/
• taishen.json · rules/market-folk-v1/
• time-gods.json · rules/market-folk-v1/
• yellow-black-dao.json · rules/market-folk-v1/
• yi-ji-rules.json · rules/market-folk-v1/
• bazi-v1.json · rules/profiles/
• market-folk-v1.json · rules/profiles/
• xiejibianfang-v1.json · rules/profiles/
• actions.json · rules/shared/
• directions.json · rules/shared/
• bad-stars.json · rules/xiejibianfang-v1/
• chongsha.json · rules/xiejibianfang-v1/
• duty-gods.json · rules/xiejibianfang-v1/
• good-stars.json · rules/xiejibianfang-v1/
• jianchu.json · rules/xiejibianfang-v1/
• pengzu.json · rules/xiejibianfang-v1/
• placeholder.json · rules/xiejibianfang-v1/
• sources.json · rules/xiejibianfang-v1/
• taishen.json · rules/xiejibianfang-v1/
• yellow-black-dao.json · rules/xiejibianfang-v1/
• yi-ji-rules.json · rules/xiejibianfang-v1/
• huangli · scripts/
• huangli_calc.py · scripts/
• __init__.py · src/lao_huangli/
• astronomy.py · src/lao_huangli/
• calendar_core.py · src/lao_huangli/
• rule_engine.py · src/lao_huangli/

SKILL.md (first lines)

# 老黄历计算技能（Lao Huangli）

## 何时使用

当用户出现以下需求时启用：

- 询问“老黄历是怎么算出来的”
- 指定日期要查询：农历、干支、节气、宜忌、冲煞、值日神
- 需要解释“哪些部分可精确计算、哪些部分来自规则流派”
- 关键词触发：`老黄历`、`黄历`、`万年历`、`宜忌`、`择日`、`通胜`、`冲煞`、`彭祖百忌`、`建除十二神`、`黄道吉日`

## 核心原则

1. **先算历法，再套规则**：先得到可靠的天文/历法基础字段，再生成宜忌。
2. **区分“确定性”与“流派性”**：节气、干支、农历可精确计算；宜忌、吉凶级别常依赖规则库。
3. **必须可追溯**：输出时明确计算边界、时区、采用的规则版本。

## 双原典边界

- **基础历法层**：以 `GB/T 33661-2017《农历的编算和颁行》` 为准，负责农历、节气、朔望、闰月、干支。
- **黄历规则层**：以 `《钦定协纪辨方书》` 为准，负责建除、黄黑道、神煞、冲煞、胎神、彭祖百忌和宜忌裁决。
- **补充古籍**：若某事实层字段暂未在 `《钦定协纪辨方书》` 中结构化落盘，可使用其他可追溯古籍补充，但必须在 `provenance.sourceRefs` 中逐项显式标明，不得冒称为协纪辨方书原文。
- **术语/展示材料**：只用于解释字段含义，不得直接替代规则原典。

## 计算总流程（工程化）

1. **输入标准化**
   - 输入：公历日期时间、时区（默认 Asia/Shanghai）、可选地点。
   - 约束：明确“日界”规则（通常以 23:00 子初或 00:00 作为换日点，需在输出声明）。

2. **基础历法计算（确定性）**
   - 公历 → 儒略日（JDN）
   - 计算当年 24 节气时刻（太阳黄经每 15°）
   - 计算朔望（新月）序列，确定农历月、闰月、月日

3. **干支计算（确定性）**
   - 年柱：以立春或春节为界（系统需固定一种并声明）
   - 月柱：以节气月为界（寅月起）
   - 日柱：基于 JDN 与甲子基准日取模 60
   - 时柱：由日干 + 时支映射得到

4. **黄历神煞/值日体系（规则表）**
   - 建除十二神、黄黑道、值神、吉神凶煞等，通常来自规则映射表。
   - 规则表需版本化（如 `ruleset: zh-traditional-v1`）。

5. **宜忌生成（规则引擎）**
   - 输入：干支、节气、建除、神煞、冲煞、月令。
   - 处理：
     - 候选事项打分（嫁娶、开市、动土、出行等）
     - 冲突裁决（优先级规则）
     - 输出宜/忌/次吉，并附理由。

6. **可解释输出**
   - 输出字段：公历、农历、干支四柱、节气、值神、建除、冲煞、胎神、彭祖百忌、宜忌。
   - 附“计算说明”：哪些是天文历法精算，哪些来自流派规则。

## 精确计算 vs 规则依赖

- **可精确计算**：公历换算、JDN、节气时刻、朔望月、农历日期、干支。
- **依赖规则库**：宜忌、吉凶等级、部分神煞解释、事项冲突裁决。
- **可能分歧点**：年界（立春/春节）、日界（23:00/00:00）、流派差异（通书体系不同版本）。

## 对话执行模板

1. 先确认日期时间与时区。
2. 给出历法基础结果（农历 + 干支 + 节气）。
3. 再给宜忌结果，并说明规则来源。
4. 明确风险提示：黄历建议仅作文化参考，不替代法律、医疗、财务和安全决策。

## 计算执行（脚本优先）

优先使用脚本计算“可精算字段”，不要直接凭网页汇总给结论。

```bash
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
```

脚本产出保证：

- 公历→农历
- 年/月/日/时干支
- 节气区间与交节时刻
- 12 时辰干支

当前脚本支持三种 profile：

- `market-folk-v1`：春节换年 + 00:00 换日（更贴近大众挂历）
- `xiejibianfang-v1`：春节换年 + 00:00 换日（规则来源预留为《协纪辨方书》体系）
- `bazi-v1`：立春换年 + 23:00 换日（更贴近八字排盘）

默认直接查询时，优先按 `market-folk-v1` 输出，效果更接近常见挂历版老黄历。

兼容说明：

- 仍兼容旧参数 `--mode market|bazi`
- 推荐新调用方式统一使用 `--profile`

脚本不会伪造：

- 宜/忌、建除、值神、吉神凶神、冲煞、胎神、彭祖百忌等规则字段（未加载规则库时明确输出“待规则库补齐”）

推荐直接运行（无需本地安装依赖）：

```bash
skills/lao-huangli/scripts/huangli 2026 3 9 12 --profile market-folk-v1 --format markdown
```

如需本地固定环境，再手动安装依赖：

```bash
uv venv .venv
uv pip install --python .venv/bin/python -r skills/lao-huangli/requirements.txt
```

当前实现状态：

From cikichen/skills, MIT.

More from cikichen/skills