| name | yi |
| description | Yi Jing divination skill - uses coin toss simulation to generate hexagrams, provides interpretation and AI analysis. |
Yi Jing Divination
Trigger
Use when user needs divination:
- "Help me divine"
- "Cast a hexagram"
- "Do a reading"
- "Yi Jing divination"
Divination Process
Step 1: Get Question
Method 1: User input directly
Ask: "What would you like to ask about?"
Method 2: Provide templates
If user unsure, offer common questions:
- Career (work, promotion, entrepreneurship)
- Wealth (investment, finances, income)
- Relationships (love, marriage)
- Academics (exams, education)
- Health
- Travel
- Other
Step 2: Cast Hexagram
Call performDivination(question) from src/divination.js:
- Toss coins 6 times (simulate 3 coins)
- Record each result (old yang, young yang, old yin, young yin)
- Determine moving yao (if any)
- Calculate main hexagram and changing hexagram
Step 3: Output Hexagram
Call formatOutput(divinationResult):
- Question
- 6 toss results
- Hexagram symbols (Unicode)
- Gua ci (judgments) and yao ci (line judgments)
- Moving yao explanation (if any)
Step 4: AI Interpretation
Call generateAIPrompt(question, divinationResult), then use LLM for interpretation.
Requirements:
- Classical Chinese style but modern understandable
- Answer:
- Overall meaning of hexagram
- Fortune for user's question
- Suggestions
- (If changing hexagram) What it means
Data Files
data/8-gua.json
8 trigrams:
- 乾, 兑, 离, 震, 巽, 坎, 艮, 坤
- Symbol, nature, yin/yang, number
data/64-gua.json
64 hexagrams:
- Name, full name, gua ci, xiang, yao ci, liu qin, shi/ying
Core Functions
| Function | Description |
|---|
| yaoGua() | Simulate coin toss, return old/young yin/yang |
| yaoLiuCi() | Toss 6 times for complete hexagram |
| calcGua(yaos) | Calculate trigram numbers from yao |
| getGuaName(yaos) | Get hexagram name and symbol |
| getZhuAndBianGua(yaos) | Get main and changing hexagram |
| getGuaData(guaInfo) | Get detailed hexagram data |
| performDivination(question) | Execute full divination |
| formatOutput(divinationResult) | Format output |
| generateAIPrompt(question, result) | Generate AI prompt |
Output Example
═══════════════════════════════════════
YI JING DIVINATION
═══════════════════════════════════════
【Question】
"My career development?"
【Tossing Process】
1st: ●●● → Yin (old yin) ✦ moving
2nd: ○○● → Yin (young yin)
3rd: ○○○ → Yang (old yang) ✦ moving
4th: ○●○ → Yang (young yang)
5th: ●○○ → Yin (young yin)
6th: ○●○ → Yang (young yang)
【Hexagram】
Main: Xun (Wind) ☴
Change: Gen (Mountain) ☶
Moving yao: First, Top (becomes Gen)
【Interpretation】
【Gua Ci】"Xiao Heng Li You Wang, Li Jian Da Ren"
【Xiang】"Following wind, jun zi yi shen ming shi shi"
═══════════════════════════════════════
AI Interpretation Example
Based on hexagram, AI should include:
Hexagram Overview
Xun (Wind) hexagram, above and below Xun, wind blows everywhere... Gua ci means "Gradual success, beneficial to see great person."
Analysis
- Currently in "advance/retreat" phase - indicates hesitation in career choices
- Xun represents wind, characteristic is "enter" - need to seize timing
- Moving yao indicates transformation period
Fortune
Overall: Good with challenges
- Initial difficulties
- Good outcome with proper approach
- Key: "Li Jian Da Ren" - seek experienced guidance
Suggestions
- Go with the flow - leverage external forces
- Balance flexibility with firm resolve
- Seize opportunities - wind goes everywhere
- Seek mentorship
Changed Hexagram (Gen)
Gen means mountain - stability after changes. Stop and reflect before advancing.
Note: Yi Jing divination is for entertainment only. Major decisions require rational analysis.
Notes
- Entertainment only - not sole basis for major decisions
- Sincerity reminder - if same question asked repeatedly, note "lack of sincerity"
- Respect - maintain humble attitude
- Rational view - "do your best, leave rest to fate"
Hexagram Symbols
| Name | Symbol | Represents |
|---|
| 乾 | ☰ | Heaven |
| 兑 | ☱ | Lake |
| 离 | ☲ | Fire |
| 震 | ☳ | Thunder |
| 巽 | ☴ | Wind |
| 坎 | ☵ | Water |
| 艮 | ☶ | Mountain |
| 坤 | ☷ | Earth |
Yao Explanations
- Old Yang (○): Yang changes to Yin
- Young Yang (○): Yang, unchanged
- Old Yin (●): Yin changes to Yang
- Young Yin (●): Yin, unchanged
Moving yao represents direction of change - key to interpretation.
