# Taibu Divination

太卜（TaiBu）占术排盘工具集与方法：八字（子平、盲派）、紫微斗数、六爻、梅花易数、奇门遁甲、...

- Repository: https://github.com/hhszzzz/taibu (725 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add hhszzzz/taibu --skill taibu-divination -g -a claude-code -y`
Codex: `npx skills add hhszzzz/taibu --skill taibu-divination -g -a codex -y`
Cursor: `npx skills add hhszzzz/taibu --skill taibu-divination -g -a cursor -y`
Gemini CLI: `npx skills add hhszzzz/taibu --skill taibu-divination -g -a gemini-cli -y`

## Description

太卜（TaiBu）占术排盘工具集与方法：八字（子平、盲派）、紫微斗数、六爻、梅花易数、奇门遁甲、 大六壬、小六壬、太乙、塔罗、西方占星、黄历择日的本地计算工具，以及周公解梦。凡涉及算命、排盘、 起卦、占卜、运势、命理、择日、宜忌、流年大运、星盘、解梦的请求（fortune-telling, divination, birth chart, BaZi, ZiWei, tarot, qimen, almanac, dream interpretation），即使用户没有点名具体 术数体系，也应使用本 skill, , 盘面必须由工具计算，不可凭记忆推算干支、卦象、星曜。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 太卜占术工具

太卜提供八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、太乙、塔罗、西方占星与黄历的排盘与详查工具，并为每个体系与流派附一个方法。计算引擎已随 skill 打包（`scripts/vendor/taibu-core.bundle.mjs`），本地直接运行，无需安装依赖，只要求环境中有 Node.js 18 或更高版本。

盘面一律由工具计算。干支、卦象、星曜的推算规则繁多，凭记忆手算既容易出错也无法复现；解读时以工具输出为唯一事实来源，不确定的细节回到输出中核对，而不是凭常识补写。

## 用法

`TB` 指本 skill 的根目录（加载 skill 时会告知）：

```bash
node "$TB/scripts/taibu.mjs" list           # 列出全部工具
node "$TB/scripts/taibu.mjs" schema bazi    # 查看参数说明与调用示例
echo '{"gender":"male","birthYear":1990,"birthMonth":5,"birthDay":20,"birthHour":8}' \
  | node "$TB/scripts/taibu.mjs" call bazi -
```

- 参数为 JSON。含中文内容时走 stdin（`call <tool> -`），避免 shell 转义问题。
- 默认输出规范文本，适合直接作为解读依据；加 `--json` 改为输出结构化数据（`structuredContent`）。
- 出错时返回中文提示（缺哪个参数、允许哪些取值），按提示修正后重试。退出码：0 成功，1 参数或业务错误，2 用法错误。

## 选择工具

The rest: https://github.com/hhszzzz/taibu/blob/HEAD/skills/taibu-divination/SKILL.md