jisu-bazi_skill

Overview

This skill connects to the Jisu Bazi (八字排盘) API to generate a birth-chart (Bazi) from a person’s birth date, time, city, and sex. It returns the four-pillar Bazi, qiankun (乾/坤造), nayin, big luck cycles (dayun), annual luck (liunian), and related calendrical details. The output is intended for entertainment and learning, not for real-world decision making.

How this skill works

The skill submits the provided name, city, year, month, day, hour, minute, sex, and lunar/solar flags to the Jisu Bazi API endpoint and forwards the API's result. It extracts key sections—bazi, qiankunzao, dayun, liunian, taiyuan, minggong, xunkong, qiyun/jiaoyun, and solar/lunar conversion info—for concise summaries. Errors from the API are surfaced with the API error code and message.

When to use it

• When you want a complete Bazi (four-pillar) chart from a birth date and time
• When you need big-luck (dayun) and annual-luck (liunian) timelines for quick interpretation
• When the user provides a lunar date or requests solar-time (taiyang) adjustments
• When you want calendrical details like previous/next solar terms and lunar hour strings
• When building a chat flow that summarizes fortune trends for career, relationships, or study

Best practices

• Always validate and normalize input date/time and city before calling the API
• Ask whether the user’s birth time is solar or lunar and whether to use solar time (istaiyang)
• Collect minutes and a city to improve accuracy for solar-term and solar-time adjustments
• Handle and display API error codes clearly (e.g., invalid date, permission or quota issues)
• Summarize technical results into plain language when explaining luck cycles or ten-gods implications

Example use cases

• User: “Please cast a Bazi for 2009-10-18 02:05 (male).” — parse input, call API, return Bazi, qiyun/jiaoyun, dayun and liunian summary
• User: “Which years are better for career?” — combine dayun and liunian entries to highlight potentially favorable years
• User: “I only know the lunar birthday.” — set islunar=1 and run the chart, noting lunarmonth/lefthand adjustments
• User: “Should we use solar time for this city?” — set istaiyang=1 when city suggests a solar-time correction and explain the change
• Developer: batch-generate archived charts for an archive or backup workflow