AI Agent Hub
Back to skills
Shefu Hexagram Analysis icon

Shefu Hexagram Analysis

Knowledge Management Updated 2026.08.29

Paste the following prompt into your AI chat to install this skill:

Please follow https://skillhub.cn/install/skillhub.md to install @user_c3004734/shefu.

About this skill

What It Addresses

Shefu Hexagram Analysis turns Shefu guessing and simple divination-style questions into an inspectable analysis pipeline. Instead of returning a flat auspicious or inauspicious verdict, it breaks vague intent into intermediate states such as hexagram, moving yao, five phases, najia, and feature mappings, which is useful for demonstrating yixue rules, modeling hexagram features, or structured cultural play.

How It Works

The skill runs in staged steps:

  • S1 casting: runs python scripts/qigua.py --json to generate the base hexagram, upper trigram, lower trigram, moving yao, changed hexagram, and calendar fields; if calendar data is missing, it degrades by skipping month-jian weighting and the color system.
  • S3 analysis: reads data/guaci_db.json, data/najia_table.json, the feature-library JSON file, and profile.json, then applies the rules in shared/principles.md for five-phase generation/restriction, ti-yue assignment, and feature mapping.
  • S4 review: after each round, python scripts/update_kb.py can update the feature library or user profile, and records/ stores Markdown notes with the hexagram, analysis result, and player judgment.

When data is missing, the skill degrades explicitly: without the feature library it falls back to pure hexagram analysis; without a profile it uses default weights; without guaci_db.json it stops and prompts. The design goal is to make hexagram interpretation a transparent, data-driven, and reviewable workflow.

Boundaries and Caveats

  • Intended for cultural education and entertainment only, not for medical, financial, legal, investment, or other high-stakes decisions.
  • It does not judge fortune or misfortune, and avoids conclusive wording such as “certain,” “inevitable,” or “great auspice.”
  • Outputs are interpretive and speculative feature portraits; final judgment remains with the user.

Use Cases

  • Run a cultural Shefu game where players provide object clues and the AI records the reasoning basis for later review.
  • Use it while documenting yixue rules to break moving yao, five phases, and najia mappings into inspectable data fields for review.
  • Build incremental user profiles by writing each player judgment into records and updating the feature library after each round cycle.
  • In a recreational divination setting, generate a possible object portrait from trigrams and feature mappings after casting the hexagram result.

Best For

  • Yixue teaching staff: need to present hexagrams, najia, and feature mappings as inspectable analysis steps for students.
  • Cultural game designers: need to turn Shefu guessing into a reviewable interactive workflow with recorded player judgments.
  • Personal knowledge-base maintainers: need to log each round's judgment and incrementally update feature-library preferences.
  • Hexagram feature-modeling engineers: need to split five-phase rules and ti-yue assignment into data fields.