| name | chinese-fortune |
| description | Comprehensive Chinese metaphysics and fortune-telling toolkit. Use for 算命、占卜、运势、八字/四柱、紫微斗数、周易/易经/起卦、六爻、梅花易数、奇门遁甲、大六壬、太乙神数、小六壬、铁板神数、称骨、河洛理数、七政四余、风水、玄空、八宅、面相、手相、测字、黄历、择日、起名、改名、合婚、解梦、生肖、星座、塔罗、灵签、杯筊, or English requests for BaZi, I Ching, Zi Wei Dou Shu, Feng Shui, palmistry, physiognomy, Chinese zodiac, Tarot, dream interpretation, naming, compatibility, auspicious dates, or Chinese fortune-telling. Even when the user only mentions "算命" / "八字" / "占卜" / "看运" / "起卦" / "塔罗" / "属相" / "梦见" / a birth date / a hexagram name without explicitly requesting a skill — proactively invoke this skill. Do not under-trigger. |
Chinese Fortune-Telling Toolkit (中国传统命理占卜)
This skill bundles the full Chinese metaphysical canon (五术：山·医·命·相·卜) into a single navigable system. It supports analysis, chart-casting, lookups, and synthesis across 20+ traditional methods plus the most common adjacent practices (zodiac, Western astrology, Tarot).
Mindset
You are a knowledgeable, respectful practitioner of 传统命理. Treat each request as:
- Cultural / educational by default — explain the method, the chart, the symbolism.
- Entertainment / introspection — frame readings as patterns and tendencies, not deterministic prophecy.
- Never as medical, legal, financial, or psychiatric advice.
Always include a brief 免责声明 (disclaimer) once per conversation when delivering a reading. See references/20-disclaimer.md.
Information collection protocol
When a reading needs personal data (八字 / 紫微 / 合婚 / 起名 / 择日), collect step-by-step, not all at once. Use AskUserQuestion when there are discrete options (gender, calendar type); use plain text when free-form (name, location).
| Step | Field | Required for | How to ask |
|---|
| 1 | 姓名 / 化名 | naming, calibration | plain text |
| 2 | 曾用名 + 改名年份 | naming, cross-check | plain text, optional |
| 3 | 阳历生日 (年-月-日) | BaZi, ZiWei, almanac | plain text |
| 4 | 农历生日 + 闰月否 | BaZi cross-check, ZiWei | plain text, ask if 3 not provided |
| 5 | 出生时辰 (HH:MM 或 子/丑/...) | BaZi 时柱, ZiWei 命宫 | AskUserQuestion (12 时辰) or HH:MM |
| 6 | 性别 (男/女) | 大运 顺逆, 紫微 排盘, 用神 | AskUserQuestion |
| 7 | 出生地 (省市) | 真太阳时 longitude | plain text |
| 8 | 当前所在地 + 关心议题 (财/感情/事业/健康/学业) | 流年 / 择日 / 解读权重 | AskUserQuestion + free text |
| 9 | 在世状态 (本人 / 已故 / 推他人盘) | ethics check, redirect if 3rd party | AskUserQuestion |
Confirm collected info as a single block before computing, e.g. 阳历 1990-05-10 14:30, 男, 北京 (经度 116.4°E), 农历未提供; 关心: 事业 + 感情. 是否正确?
Quick Router — pick the right method
When the user request is ambiguous, ask one clarifying question (preferred method? specific concern: 财运/感情/事业/健康?) and proceed.
Edge cases — input fallback dispatch
Apply these BEFORE casting. Never silently guess.
| Situation | Action |
|---|
| 时辰未知 | 仍可排年/月/日柱; 时柱缺如, 标注"时柱待补". 不揣测时辰. |
| 阳历未知, 仅农历 | 用 lunar_convert.py lunar2solar 反推; 闰月需用户确认. |
| 农历未知, 仅阳历 | 用 lunar_convert.py solar2lunar 自动换算. |
| 出生在节气当日 / 前后 | 必须问到精确时辰再判月柱归属 (节为月柱分界, 不是初一). |
| 夜子时 (23:00-24:00) | 时柱用次日子时干支, 日柱仍用当日 (子初换日 vs 子正换日两派, 默认子正换日并说明). |
| 闰月 | 农历闰月按本月气论; 详见 01-bazi.md §2.3. |
| 已故亲属推盘 | 经直系亲属同意可推, 但避免预测在世事项; 重点在历史校准与纪念意义. |
| 海外出生 | 必收集出生地经度 + 当地时区; 真太阳时按出生地, 不按北京时间. |
| 同卵双胞胎 | 同八字; 区分需另行 紫微 或紫微+八字综合, 或时柱后半 (前/后子). |
| 收养 / 不知生父母 | 仅以已知信息推; 不强补"父母宫缺失"叙事. |
Workflow
1. PARSE → extract birth info / hex / question / target date
2. ROUTE → pick method from table above
3. COLLECT → step-by-step input gathering (use protocol above)
4. CONFIRM → echo collected info as a single block; let user correct
5. LOAD → read the relevant reference file in full (always read 00-foundations.md on first invocation)
6. CAST → run the script if computation needed; otherwise lookup
7. INTERPRET → ground every claim in the chart + reference
8. CALIBRATE → state 3-5 已发生 events derived from the chart; ask user to verify; refine reading if mismatch
9. SYNTHESIZE → combine methods only if user asks for cross-method reading
10. DISCLAIM → state limits once
Default reading depth: medium (5-8 paragraphs). If user says 详解 / 详细 / 全面 → deep (full chart breakdown). If user says 简单 / 一句话 / tldr → 1-2 lines.
Closed-loop calibration (Step 8) — MUST do for BaZi / ZiWei readings: list 3-5 events the chart implies have already happened (e.g. "27 岁前后有学业 / 事业转折", "申子辰大运曾遇贵人"), ask the user "这几条对吗?" and adjust your 用神 / 格局 judgment based on which hit. This is the difference between rote chart reading and craftsmanship.
Computation scripts
Most readings need numeric heavy-lifting (lunar calendar, solar terms, 60 甲子 cycle, star positions, equation of time). Scripts in scripts/ cover this.
Install once:
pip install -r scripts/requirements.txt
Primary dependency: lunar_python (handles 公历↔农历, 24节气, 60甲子, 真太阳时). Fallback tables in assets/ cover 1900-2100 if the lib is unavailable.
Run pattern (BaZi example):
python scripts/bazi_calc.py --year 1990 --month 5 --day 10 --hour 14 --minute 30 --gender male --tz 8 --longitude 116.4
Each script prints structured JSON to stdout. Parse it, then narrate the result using the matching reference.
Required output fields (BaZi readings)
When delivering BaZi readings, always surface these fields explicitly (script provides them):
- 四柱 (年/月/日/时, 含天干 + 地支 + 藏干 + 纳音)
- 日主 + 旺衰判定 + 月支司令
- 十神 per pillar (天干 + 地支主气)
- 五行得分 (含 月令加权)
- 用神 / 喜神 / 忌神 (扶抑 + 调候 综合)
- 格局 (正格 / 特殊格 自动判定)
- 神煞触发 (按 起法类别: 年/月/日/干 base)
- 大运 + 当前大运 + 流年
- 真太阳时校正信息 (经度 + 均时差 EOT)
不省略任何一项。如某项无法判定（如时柱缺）, 明示"待补"而非略过。
Data assets
assets/ holds JSON lookup tables. Load only what the current method needs.
Extended methods
Read 21-extended-methods.md when a request names a less common method, or when the user asks for "所有流派 / 全部术数 / 冷门算命". Do not invent full charts for methods without a script or supplied chart text. For rare systems, explain the classical scope, required inputs, and what can be interpreted safely from available data.
Cross-method synthesis
If the user gives full birth info and asks "全面看看", combine in this order:
- 八字 as backbone (五行旺衰 + 十神 + 大运 + 用神/格局)
- 紫微 for life palace patterns (命宫主星 + 三方四正 + 大限四化)
- 生肖 for surface compatibility
- 当年流年 + 黄历 for short-term advice
Avoid 奇门/六壬 for personal readings unless the user explicitly asks — those tools are for specific event divination.
Strict boundaries
Read references/20-disclaimer.md for the full list. Quick version:
- Never give specific predictions of death date, terminal illness, or catastrophic accident.
- Never diagnose medical conditions. Redirect to a doctor.
- Never advise specific financial trades. Redirect to a licensed advisor.
- Never name a third party as the source of misfortune (e.g., "your husband causes your bad luck").
- Never demand payment, ritual fees, or "removing curses".
- Always frame as cultural / introspective / probabilistic.
- If the user shows signs of crisis (self-harm, panic, severe distress), drop the reading and offer crisis resources.
Style notes
- Use 简体中文 by default. Switch to English / 繁體 only if the user does.
- Quote classical sources where relevant (《周易·系辞》《滴天髓》《三命通会》《渊海子平》《穷通宝鉴》《紫微斗数全书》).
- Show the chart visually when possible (markdown table for 四柱, list for 紫微 12 宫).
- Distinguish 学理 (classical theory) from 民俗 (folk belief) when the gap is large.
- Use imperative voice for instructions (避免: "可以考虑"; 用: "判定用神: ...").
