Tafu BaZi

Use this skill when the user asks for:

• - 八字 / BaZi 排盘
• 主题解读，例如性格底色、事业财富、感情、健康、年度运势
• 双人合盘 / compatibility / synastry
• 灵魂歌曲

Tafu is the source of truth for all chart math and paid analysis. Do not improvise the actual BaZi chart or paid reading if the API is available.

Preconditions

• - The host should inject TAFU_API_KEY from skills.entries.tafu_bazi.apiKey.
• Optional override: skills.entries.tafu_bazi.env.TAFU_API_BASE_URL.
• If the key is missing, stop and tell the user to create a key at https://tafu.me/developers, then configure skills.entries.tafu_bazi.apiKey.

Use {baseDir}/scripts/tafu_api.sh for every API call. It reads:

• - INLINECODE6
• INLINECODE7 if present
• otherwise defaults to INLINECODE8

If you need concrete payload examples, read {baseDir}/references/examples.md.

Input Rules

• - Collect the user's language and reply in that language.
• Ask for missing required birth fields before calling paid endpoints.
• For best accuracy, collect:

• - If the birth minute is unknown, ask once. If the user still does not know, call out the assumption before using 00.
• If the user gives a lunar date and the month could be leap, use GET /bazi/leap-month/:year before confirming isLeapMonth.
• If the user gives a free-form location and it looks ambiguous, use GET /bazi/coordinates?location=... first.

API Workflow

1. Deterministic charting

For raw chart calculation, call:

• - INLINECODE14

Use the normalized JSON payload expected by the API. Prefer these keys:

• - INLINECODE15
• INLINECODE16
• INLINECODE17
• INLINECODE18
• INLINECODE19
• INLINECODE20
• INLINECODE21
• INLINECODE22
• INLINECODE23

2. Paid thematic reading

For a single-person reading, call:

• - INLINECODE24

Payload:

• - INLINECODE25
• INLINECODE26

Valid theme values:

• - INLINECODE28
• INLINECODE29
• INLINECODE30
• INLINECODE31
• INLINECODE32
• INLINECODE33

3. Soul song

For soul-song generation, call:

• - INLINECODE34

Payload:

• - INLINECODE35

4. Synastry

For two-person compatibility, call:

• - INLINECODE36

Payload:

• - INLINECODE37
• INLINECODE38

5. Polling async tasks

INLINECODE39, /soul-song, and /synastry may return an already completed result or an async task.

If the response includes a result, use it immediately.

If the response includes taskId and status:

1. 1. Poll INLINECODE45
2. Wait about 5 seconds between polls
3. Poll up to 12 times, or stop earlier if status becomes completed or INLINECODE47
4. If it is still pending after the polling window, tell the user the task is still running and include the INLINECODE48

Output Rules

• - Preserve the API result as the factual source.
• You may add a short top summary, but do not discard or rewrite away important structured output.
• Surface creditsUsed and creditsRemaining when returned.
• If the API returns viewUrl, include it.
• On 402 or INSUFFICIENT_CREDITS, tell the user to recharge Credits at https://tafu.me/developers/billing.
• On 401 or INVALID_API_KEY, tell the user to rotate or reconfigure the API key.
• On input validation errors, ask for the missing or invalid field instead of guessing.
• If the API fails, do not fall back to a hallucinated BaZi reading.

Execution Notes

• - Keep secrets out of the chat transcript.
• Use temporary JSON files for complex payloads instead of long inline shell escaping.
• Only call paid endpoints after the user has clearly asked for that capability.