yi

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:

1. Career (work, promotion, entrepreneurship)
2. Wealth (investment, finances, income)
3. Relationships (love, marriage)
4. Academics (exams, education)
5. Health
6. Travel
7. Other

Step 2: Cast Hexagram

Call performDivination(question) from src/divination.js:

1. Toss coins 6 times (simulate 3 coins)
2. Record each result (old yang, young yang, old yin, young yin)
3. Determine moving yao (if any)
4. 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:

1. Classical Chinese style but modern understandable
2. 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

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

1. Go with the flow - leverage external forces
2. Balance flexibility with firm resolve
3. Seize opportunities - wind goes everywhere
4. 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

1. Entertainment only - not sole basis for major decisions
2. Sincerity reminder - if same question asked repeatedly, note "lack of sincerity"
3. Respect - maintain humble attitude
4. Rational view - "do your best, leave rest to fate"

Hexagram Symbols

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.