
Bazi Mingli
Give an agent structured guidance to perform Bazi (Four Pillars) chart calculation and interpretation when users ask in Chinese or English for traditional birth-time fortune analysis.
Overview
bazi-mingli is an agent skill for the Idea phase (Discover) that performs structured Bazi Four Pillars charting and interpretation when users request Chinese birth-chart divination.
Install
npx skills add https://github.com/wolke/bazi-mingli --skill bazi-mingliWhat is this skill?
- Structured Four Pillars workflow: year, month, day, and hour pillars from birth datetime
- Reference library for 天干地支, 五行, 十神, 用神, 大運流年, and domain topics (career, marriage, health)
- bazi_calc.py script for deterministic chart calculation
- Ethics guidelines (ETHICS.md) for responsible divination-style responses
- Onboarding prompts that collect gender, datetime precision, and optional birthplace for timezone correction
- 10 reference topic files under references/ (e.g. wuxing, shishen, dayun-liunian)
- Dedicated ETHICS.md and bazi_calc.py calculator script
- Four-pillar components: 年柱, 月柱, 日柱, 時柱
Adoption & trust: 1.1k installs on skills.sh; 42 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Users ask for 八字排盤 or fortune analysis and generic chat answers skip pillar math, ethics, and the standard reference structure for 五行 and 大運.
Who is it for?
Builders shipping Chinese-language lifestyle, wellness, or entertainment agents who need repeatable Bazi workflows and reference-backed interpretations.
Skip if: Medical, legal, or investment decisions; users who need Western astrology only; production incident response or standard SaaS engineering tasks.
When should I use this skill?
Users request 八字, 四柱, 命盤, 排盤, 算命, 命理, 五行, 大運, 流年, bazi, four pillars, Chinese astrology, or birth chart analysis.
What do I get? / Deliverables
The agent collects complete birth inputs, applies the documented calculation and reference modules, and returns a structured命盤 analysis with clear limitations per ETHICS.md.
- Complete four-pillar chart breakdown
- Five-element and ten-gods analysis with optional thematic reading sections
- 大運/流年 commentary when requested and data allows
Recommended Skills
Journey fit
Discover is the canonical shelf because the skill is invoked when someone is exploring personal or timing context before committing to major life or business decisions—not when operating production systems. Discover fits open-ended exploration and novelty requests (八字, 排盤, 流年) that do not map to standard dev tooling phases.
How it compares
A domain-specific ritual and reference pack for traditional Bazi—not a data analytics or BI dashboard skill.
Common Questions / FAQ
Who is bazi-mingli for?
Developers and solo builders embedding Chinese metaphysical consultation flows in agents, plus end users requesting formal 四柱推命-style readings through chat.
When should I use bazi-mingli?
In Idea/Discover when exploring personal timing narratives, or anytime user messages trigger 八字, 排盤, 流年, or four pillars birth-chart analysis.
Is bazi-mingli safe to install?
Read ETHICS.md in the skill, treat outputs as cultural guidance not fact, and review the Security Audits panel on this page before running bundled Python scripts.
SKILL.md
READMESKILL.md - Bazi Mingli
# 八字命理占卜技能 (Bazi Mingli Divination Skill) 八字命理(四柱推命)專業排盤與解命系統。源自中國傳統命理學,以出生年月日時的天干地支組合,推算人生命運與運勢。 ## 使用時機 當用戶請求以下類型的幫助時,應啟用此技能: 1. **排盤相關**:請求八字排盤、命盤查詢、生辰八字分析 2. **命理諮詢**:詢問五行、十神、大運、流年相關問題 3. **運勢預測**:事業財運、感情婚姻、健康運勢 4. **關鍵詞觸發**:「八字」「四柱」「命盤」「排盤」「算命」「命理」「五行」「大運」「流年」 ## 核心功能 - 八字排盤(年柱、月柱、日柱、時柱) - 五行分析(金木水火土分布) - 十神配置分析 - 日主強弱判斷 - 用神喜忌推斷 - 大運流年預測 - 婚姻、事業、財運、健康專項分析 ## 技能結構 ``` /bazi-mingli/ ├── SKILL.md ← 本文件(核心指南) ├── ETHICS.md ← 倫理準則 ├── README.md ← 專案說明 ├── references/ │ ├── tiangan-dizhi.md ← 天干地支基礎 │ ├── wuxing-shengke.md ← 五行生剋詳解 │ ├── shishen.md ← 十神定義與應用 │ ├── rizhu-qiangruo.md ← 日主強弱判斷 │ ├── yongshen.md ← 用神喜忌法則 │ ├── dayun-liunian.md ← 大運流年推算 │ ├── hunyin-ganqing.md ← 婚姻感情專論 │ ├── shiye-caiyun.md ← 事業財運專論 │ ├── jiankang.md ← 健康疾病專論 │ └── geju-fenxi.md ← 格局分析總論 └── scripts/ └── bazi_calc.py ← 八字計算工具 ``` ## 用戶引導 ### 首次使用提示 當用戶首次請求排盤時,應詢問完整的出生資訊: ``` 🎋 八字命理排盤系統 請提供您的出生資訊: 1. 出生日期(西曆/公曆):年/月/日 2. 出生時間:幾點幾分(越精確越好) 3. 性別:男/女 4. 出生地點(可選,用於時區校正) 📌 注意事項: - 如知道農曆生日,請註明 - 時辰不確定可提供範圍 - 出生時間會影響時柱準確度 ``` ### 主動詢問問事方向 排盤完成後,可引導用戶聚焦具體問題: ``` 命盤已排出,您可以詢問: 📈 事業發展與職業方向 💰 財運狀況與投資建議 💕 婚姻感情與人際關係 🏥 健康狀況與養生建議 📅 今年/明年流年運勢 🔮 特定時間點的重大決策 請告訴我您最關心的方向。 ``` ## 農曆與節氣說明 ### 重要提醒 八字排盤的月柱以**節氣**為準,非農曆初一為月份起點。 ### 節氣交接表 | 節氣 | 大約時間 | 月柱起始 | |------|----------|----------| | 立春 | 2月3-5日 | 寅月開始 | | 驚蟄 | 3月5-7日 | 卯月開始 | | 清明 | 4月4-6日 | 辰月開始 | | 立夏 | 5月5-7日 | 巳月開始 | | 芒種 | 6月5-7日 | 午月開始 | | 小暑 | 7月6-8日 | 未月開始 | | 立秋 | 8月7-9日 | 申月開始 | | 白露 | 9月7-9日 | 酉月開始 | | 寒露 | 10月8-9日 | 戌月開始 | | 立冬 | 11月7-8日 | 亥月開始 | | 大雪 | 12月6-8日 | 子月開始 | | 小寒 | 1月5-7日 | 丑月開始 | ### 年柱交接 - 年柱以**立春**為界,非農曆正月初一 - 立春前出生者,年柱屬前一年 ### 時辰對照 | 時辰 | 地支 | 現代時間 | |------|------|----------| | 子時 | 子 | 23:00 - 00:59 | | 丑時 | 丑 | 01:00 - 02:59 | | 寅時 | 寅 | 03:00 - 04:59 | | 卯時 | 卯 | 05:00 - 06:59 | | 辰時 | 辰 | 07:00 - 08:59 | | 巳時 | 巳 | 09:00 - 10:59 | | 午時 | 午 | 11:00 - 12:59 | | 未時 | 未 | 13:00 - 14:59 | | 申時 | 申 | 15:00 - 16:59 | | 酉時 | 酉 | 17:00 - 18:59 | | 戌時 | 戌 | 19:00 - 20:59 | | 亥時 | 亥 | 21:00 - 22:59 | ## 八字排盤基礎 ### 天干(10個) | 天干 | 甲 | 乙 | 丙 | 丁 | 戊 | 己 | 庚 | 辛 | 壬 | 癸 | |------|----|----|----|----|----|----|----|----|----|----| | 五行 | 木 | 木 | 火 | 火 | 土 | 土 | 金 | 金 | 水 | 水 | | 陰陽 | 陽 | 陰 | 陽 | 陰 | 陽 | 陰 | 陽 | 陰 | 陽 | 陰 | | 序數 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | ### 地支(12個) | 地支 | 子 | 丑 | 寅 | 卯 | 辰 | 巳 | 午 | 未 | 申 | 酉 | 戌 | 亥 | |------|----|----|----|----|----|----|----|----|----|----|----|----| | 五行 | 水 | 土 | 木 | 木 | 土 | 火 | 火 | 土 | 金 | 金 | 土 | 水 | | 生肖 | 鼠 | 牛 | 虎 | 兔 | 龍 | 蛇 | 馬 | 羊 | 猴 | 雞 | 狗 | 豬 | | 藏干 | 癸 | 己癸辛 | 甲丙戊 | 乙 | 戊乙癸 | 丙戊庚 | 丁己 | 己丁乙 | 庚壬戊 | 辛 | 戊辛丁 | 壬甲 | ### 四柱排法 1. **年柱**:出生年的干支(以立春為界) 2. **月柱**:出生月的干支(以節氣為界) 3. **日柱**:出生日的干支(以子時為界) 4. **時柱**:出生時辰的干支 ### 月柱天干推算口訣 ``` 甲己之年丙作首,乙庚之年戊為頭, 丙辛之年庚開始,丁壬壬寅順行流, 戊癸之年甲寅起,正月寅位不須求。 ``` | 年干 | 正月(寅月)天干 | |------|------------------| | 甲、己 | 丙 | | 乙、庚 | 戊 | | 丙、辛 | 庚 | | 丁、壬 | 壬 | | 戊、癸 | 甲 | ### 時柱天干推算口訣 ``` 甲己還加甲,乙庚丙作初, 丙辛從戊起,丁壬庚子居, 戊癸何方發,壬子是真途。 ``` | 日干 | 子時天干 | |------|----------| | 甲、己 | 甲 | | 乙、庚 | 丙 | | 丙、辛 | 戊 | | 丁、壬 | 庚 | | 戊、癸 | 壬 | ## 五行生剋 ### 五行相生 ``` 木 → 火 → 土 → 金 → 水 → 木(循環) ``` - 木生火:木燃燒生火 - 火生土:火燒成灰燼為土 - 土生金:土中藏金礦 - 金生水:金屬融化成液態 - 水生木:水滋潤草木生長 ### 五行相剋 ``` 木 → 土 → 水 → 火 → 金 → 木(循環) ``` - 木剋土:草木破土而出 - 土剋水:土築堤壩攔水 - 水剋火:水能滅火 - 火剋金:火可熔金 - 金剋木:金斧伐木 ### 五行旺衰(季節) | 季節 | 旺 | 相 | 休 | 囚 | 死 | |------|----|----|----|----|-----| | 春(寅卯辰月) | 木 | 火 | 水 | 金 | 土 | | 夏(巳午未月) | 火 | 土 | 木 | 水 | 金 | | 秋(申酉戌月) | 金 | 水 | 土 | 火 | 木 | | 冬(亥子丑月) | 水 | 木 | 金 | 土 | 火 | | 四季末(辰戌丑未月) | 土 | 金 | 火 | 木 | 水 | ## 十神系統 ### 十神定義 以日干為「我」,與其他干支的關係: | 十