Skip to content

README.en.md

Latest commit

 

History

History
166 lines (120 loc) · 8.39 KB

README.en.md

File metadata and controls

166 lines (120 loc) · 8.39 KB
Raw

Liki

Liki — Professional Skill for Chinese Metaphysics

npx skills add ml8s/liki

Introduction

Liki is a Professional Skill for Chinese Metaphysics — built on a precision computation engine and a systematic methodology library, providing reliable and verifiable tools for practitioners. BaZi, ZiWei, naming, Liuyao, Qimen, date selection, Feng Shui — all available in your AI assistant.

Covers 8 independent domains, with 9 methodology documents, dual-system cross-validation (BaZi + ZiWei), and a generate → review → revise three-stage report pipeline.

✨ Get a Chinese name — Non-Chinese speakers can get an authentic Chinese name rooted in traditional naming principles. The AI matches phonetic sounds to Chinese surnames, then recommends given names based on your birth profile — considering Five Elements balance, auspicious meanings, and classical reference.

Domains

Domain Description
BaZi Chart casting, Yongshen, Geju, Combination & Clash, compatibility, DaYun/LiuNian
ZiWei Twelve palaces, SiHua, Sanfang Sizheng, special patterns, DaXian/LiuNian
Naming BaZi Yongshen + Wuge-Sancai. Foreigners can get an authentic Chinese name from their English name — phonetically matched surname plus Five Element-balanced given name
Liuyao Hexagram casting → charting → judgment
Qimen Chart casting, judgment, date selection
Huangli Daily almanac inquiry
Bazhai Mingua + Men/Zhu/Zao analysis
Xuankong Flying Star chart, Sanyuan Jiuyun, annual flying star

What You Can Do

You want to Use
Read a Bazi or Ziwei chart, check decade/annual fortune Mingli
Name a baby or company Qiming
Pick an auspicious date, ask about fortune, find a lost item Divination
Evaluate home or office Fengshui Fengshui
Get a meaningful Chinese name from your English name Naming

Features

  • Hour calibration — When birth time is uncertain, use past life events to verify the hour. Mandatory after chart casting for adults
  • Yongshen aggregation — Three schools (Geju/Tiaohou/Fuyi) aggregated by priority: Geju sets the framework, Tiaohou adjusts, Fuyi fine-tunes; skipped when output is empty
  • Astronomical backend — True Solar Time / DST / lat-lon timezone correction; chart calculation does not rely on LLM inference
  • Dual-system cross-validation — BaZi and ZiWei charted independently, conclusions cross-referenced for greater confidence
  • 9 methodology documents — yongshen/geju/tiaohou/wangshuai/hehui/gongwei/dayun/shishen/hepan
  • Three-stage report pipeline — generate → review → revise, quality-controlled
  • Semantic versioning — VERSION file + CHANGELOG + self-check update mechanism
  • MingLi-Bench continuous improvement — 160 real exam questions from World Fortune Telling Contest, accuracy improved from 36% to 49.4% after methodology overhaul in v1.38 (checklist-based strength analysis, yongshen priority reordering, parallel chong-he analysis)
  • English→Chinese naming — Non-Chinese users can get a meaningful Chinese name based on their English name's phonetics

Architecture

liki (this repo)      → Skill (workflow definitions + methodology docs)
liki-engine           → Astronomical API ([open-source calculation engine](https://github.com/ml8s/liki-engine))
[liki.hk](https://liki.hk)               → Official website built on engine + skill

Project Structure

domains/bazi/       → BaZi: SKILL + report format + knowledge/methodology docs
domains/ziwei/      → ZiWei: SKILL + report format + knowledge/methodology docs
naming/     → Naming: SKILL + report format
domains/liuyao/     → Liuyao: SKILL + report format
domains/qimen/      → Qimen: SKILL + report format
domains/huangli/    → Huangli: SKILL + report format
domains/bazhai/     → Bazhai: SKILL + report format
domains/xuankong/   → Xuankong: SKILL + report format
webapp/    → Web application pipeline (LifeBook + Hepan, generate → review → revise)

Install

npx skills add ml8s/liki
npx skills add https://liki.hk/   # or from the website

Then talk to your AI assistant:

Skills Detail

Mingli (命理)

Combined Bazi and Ziwei analysis — chart casting, Yongshen, Geju determination, Combination & Clash, compatibility (Bond), decade cycles, annual trends, comprehensive advice, and historical event calibration.

Bazi chart, 1990-05-20 12:00 Beijing, male What's my fortune this year Check our compatibility: me (1984-06-15 Beijing, male) and her (1986-09-20 Shanghai, female) ZiWei chart for 1990-05-20 Beijing, male

Qiming (起名)

Naming service that combines Bazi Yongshen with Wuge (五格, five-grid) and Sancai (三才, three-talent) numerology.

Name my baby boy, born 2024-03-15 at 10:00 Guangzhou, surname Wang Help me rename myself, born 1995-08-10 Shenzhen, female, surname Li Review the name 'Zhang Wei' I'm an American. Give me a Chinese name. My full name is Emily Johnson.

Wengua / Divination (问卦)

LLM-driven routing that selects the corresponding method based on your question:

  • Auspicious date (when is good) → Huangli (黄历, Chinese almanac)
  • Fortune inquiry (success/loss/finding things) → Liuyao (六爻, I-Ching)
  • Strategy & direction (what to do / where to go) → Qimen Dunjia (奇门遁甲)

Should we move house tomorrow? Can I find my lost keys? How's my career luck lately? Which direction should I go today?

Fengshui (风水)

Covers both Bazhai (八宅, Eight Mansions) and Xuankong (玄空, Flying Star) schools — life-trigram matching, spatial orientation, and time-dimension analysis via Sanyuan Jiuyun (三元九运).

My front door faces east. How's the Fengshui of this apartment? This house faces south. How's the Fengshui? My office is on the 8th floor, desk by the window — anything to watch out for?

References

This project's design references the following open-source projects:

Links

Disclaimer

Liki provides Chinese Astrology analysis from a traditional cultural perspective for research and reference only. Its conclusions do not constitute medical diagnosis, legal advice, financial forecasts, or major life decisions. Please maintain a rational and proactive outlook.