Chinese Almanac (古典择日)

SKILL.md

---
name: chinese-almanac
description: |
  Chinese Almanac (Xie Ji Bian Fang Shu) — Classical date selection system based on the Qing Dynasty imperial almanac. Calculate auspicious dates for marriage, business, moving, travel, and more using 12 Day Officers, Yellow/Black Roads, and Pengzu Taboos.
  古典择日（协纪辨方书体系）——基于清乾隆钦定《协纪辨方书》的择日系统。融合建除十二神、黄道黑道、天德月德天赦、彭祖百忌，提供结婚、开业、搬家、签约、出行等10类活动的择吉选日。
  中国暦（協紀辨方書）——清代乾隆帝勅撰の暦書に基づく古典的な日取りシステム。建除十二神、黄道黒道、天徳月徳天赦、彭祖百忌を融合し、結婚・開業・引越し・契約・旅行など10種類の活動に最適な日付を提案。
  When users mention: almanac, chinese calendar, auspicious date, date selection,择日, 择吉, 黄道吉日, 黄历, 中国暦, 時計, or ask to pick a good day for events.
version: 1.0.0
keywords: [almanac, chinese calendar, auspicious date, 择日, 择吉, 黄道吉日, 黄历, 协纪辨方书, 建除十二神, 中国暦, 時計, date selection, feng shui]
---

# Chinese Almanac (古典择日 / 中国暦)

A classical Chinese date selection system based on the Qing Dynasty imperial almanac 《协纪辨方书》(Xie Ji Bian Fang Shu), combining multiple layers of auspicious/inauspicious analysis.

> 🌐 **Online**: [English](https://halfct.ltd/zeri?lang=en) · [中文](https://halfct.ltd/zeri?lang=zh) · [日本語](https://halfct.ltd/zeri?lang=ja)

## What It Does

Find the **best dates** for important life events using traditional Chinese metaphysics.

为人生大事选择最佳日期，融合传统中国命理学。

重要な行事に最適な日付を伝統的な中国のメタフィジクスで選定。

## Core Systems (核心体系)

| System | Chinese | Description | 说明 |
|--------|---------|-------------|------|
| 12 Day Officers | 建除十二神 | Jianchu cycle: 建除满平定执破危成收开闭 | 12种日值循环 |
| Yellow/Black Road | 黄道黑道 | 6 auspicious + 6 inauspicious stars | 6吉星+6凶星 |
| Heavenly Virtue | 天德月德天赦 | Heavenly forgiveness & virtue stars | 天上吉神庇佑 |
| Pengzu Taboos | 彭祖百忌 | Daily stem/branch taboos | 天干地支禁忌 |
| Five Elements | 五行生克 | Wood/Fire/Earth/Metal/Water interactions | 五行相生相克 |

## 10 Activity Types (10类活动)

| Emoji | Activity | Chinese | 日本語 |
|-------|----------|---------|--------|
| 💒 | Marriage | 嫁娶 | 結婚 |
| 🏪 | Opening Business | 开业 | 開業 |
| 🏠 | Moving | 搬家 | 引越し |
| 📝 | Signing Contracts | 签约 | 契約 |
| ✈️ | Travel | 出行 | 旅行 |
| 🔨 | Renovation | 装修 | 改装 |
| 🙏 | Worship/Prayer | 祭祀 | 祈り |
| 💰 | Seeking Wealth | 求财 | 金運 |
| 👔 | Starting New Job | 上任 | 就任 |
| 💍 | Engagement | 订婚 | 約束 |

## CLI Usage

```bash
cd scripts && npm install
node cli.js 2026-06 marriage          # English output
node cli.js 2026-06 marriage --lang zh # 中文输出
node cli.js 2026-06 marriage --lang ja # 日本語出力
node cli.js best 2026-06 marriage     # Find best date
node cli.js --json 2026-06 marriage   # JSON output
```

## Output Includes

| Feature | Description | 说明 | 説明 |
|---------|-------------|------|------|
| Day Officer | 建除十二神 value | 日值 | 日の値 |
| Yellow/Black Road | Auspicious star | 黄道黑道 | 黄道黒道 |
| Heavenly Virtue | Virtue stars present | 天德月德 | 天徳月徳 |
| Pengzu Taboo | Stem/branch warnings | 彭祖百忌 | 彭祖百忌 |
| Auspicious Score | 0-10 rating | 吉祥评分 | 吉祥スコア |
| Do/Don't Lists | What to do/avoid | 宜忌 | 宜忌 |
| Best Hours | Auspicious time periods | 吉时 | 吉時 |

## Triggers (触发词)

- **English**: almanac, chinese calendar, auspicious date, date selection, pick a good day
- **中文**: 择日, 择吉, 选日子, 黄道吉日, 黄历, 古典择日, 协纪辨方书, 结婚日子, 开业日子, 搬家日子
- **日本語**: 中国暦, 時計, 吉日, 日取り, 中国暦選日

## Notes

- Based on 《协纪辨方书》(Xie Ji Bian Fang Shu), Qing Dynasty imperial almanac
- Combines 5 traditional Chinese metaphysics systems
- Entertainment purposes — not a substitute for professional advice
- 基于清乾隆钦定《协纪辨方书》，融合五大传统命理体系
- 清乾隆帝勅撰の暦書に基づく、5つの伝統中国メタフィジクスを融合