SKILL.md
Chinese Calendar Query
Queries the 接口盒子 API (API ID: 278) to retrieve comprehensive traditional Chinese calendar (黄历) information for any date.
Execution Rule
Run the user's requested command directly without pre-checking dependencies, environment variables, or configuration. If something is wrong, the script will fail with a clear error — check and fix only then.
Environment Variables
| Variable | Description |
|---|---|
JKHZ_ID |
接口盒子 (apihz.cn) user ID |
JKHZ_KEY |
接口盒子 API key |
The script loads these from ~/.wmyskills/.env (shared across skills) automatically; a scripts/.env in the script directory takes priority if present. Use scripts/.env.example as the template — add the variables to ~/.wmyskills/.env, never overwriting an existing file.
Requirements
pip install python-dotenv tzdataUsage
Script: scripts/getzdday.py
Query today
python scripts/getzdday.pyQuery a specific date
python scripts/getzdday.py 2025-06-05Output raw JSON (debugging)
python scripts/getzdday.py 2025-06-05 --jsonOutput Categories
The script organizes returned data into these categories:
| Category | Fields |
|---|---|
| 📆 Gregorian Calendar (公历) | Year, month, day, weekday, leap year |
| 🌙 Lunar Calendar (农历) | Lunar year, month, day |
| 🎊 Festivals (节日) | Solar festivals, lunar festivals |
| ⭐ Constellation & Zodiac (星座与生肖) | Constellation, Chinese zodiac, daily zodiac |
| 📜 Stems & Branches (干支) | Year/month/day Ganzhi, day Nayin |
| 🌿 Solar Terms & Phenology (节气与物候) | Solar term, description, Wuhou, Shujiu, Sanfu |
| ☯ Auspicious/Inauspicious (宜忌) | Yi (宜), Ji (忌), auspicious/inauspicious gods |
| 🧭 Directions (方位) | Xi (喜), Cai (财), Fu (福), Gui (贵) spirit directions |
| ⚠️ Clash & Sha (冲煞) | Xiangchong, Richtungschong, Tian Shen, Huang/Hei Dao |
| 🔢 Star & Spirit (值星与神煞) | Zhi Xing (12 value stars), 12 spirits, Liuyao, moon phase |
| 🌟 Mansions (星宿) | 28 mansions, animal, luck, 7 luminaries, 4 palaces, 4 symbols |
| 📖 Peng Zu & Fetal God (彭祖与胎神) | Peng Zu's hundred taboos, fetal god direction, Taisui |
| 📅 Buddhist/Taoist Calendar (佛道历) | Buddhist calendar, Taoist calendar, Islamic calendar |
| 📊 Other (其他) | Wuxing (5 elements), Julian day, 9 stars, season |
Notes
- Defaults to today's date (Asia/Shanghai timezone)
- API year range: 1800 to next year
- Formatted output is suitable for direct display;
--jsonfor debugging - The API may return different fields per date; the script dynamically displays all non-empty fields
- Match the user's language. The output language MUST match the language of the user's question. If the user asks in Chinese, output all category labels and descriptions in Chinese; if in English, output in English.