About taibu-divination
Taibu is a divination skill with 15 tools for charting and consultation across Chinese systems, Tarot, Western astrology, and almanac lookup. Its calculation engine is bundled for local Node.js use, and outputs serve as the factual basis for interpretations.
Key features
- 0115 divination and charting tools
- 02Local bundled calculation engine
- 03Text or structured JSON output
- 04Parameter schemas and examples
- 05Interpretation guidance by system
Use cases
- 01Generating a Bazi or Ziwei chart
- 02Casting a Liuyao or Qimen reading
- 03Drawing Tarot cards for a spread
- 04Checking almanac details for a date
MCP support
MCP-compatible clients can use the same tool set through the taibu-mcp npm package over stdio or the public MCP endpoint.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ hhszzzz/ taibu --skill taibu-divinationAfter installing, type/taibu-divinationin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
evals/evals.jsoninterpretation/almanac.mdastrology.mdbazi.mddaliuren.mdliuyao.mdmeihua.mdqimen.mdtaiyi.mdtarot.mdxiaoliuren.mdziwei.mdreferences/almanac.mdastrology.mdbazi_dayun.mdbazi_pillars_resolve.mdbazi.mddaliuren.mdliuyao.mdmeihua.mdqimen.mdtaiyi.mdtarot.mdxiaoliuren.mdziwei_flying_star.mdziwei_horoscope.mdziwei.mdscripts/taibu.mjsDetails
From the project README太卜占术工具
太卜提供 15 个占术与命理排盘工具,涵盖八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、太乙、塔罗、西方占星与黄历。计算引擎已随 skill 打包(scripts/vendor/taibu-core.bundle.mjs),本地直接运行,无需安装依赖,只要求环境中有 Node.js 18 或更高版本。
盘面一律由工具计算。干支、卦象、星曜的推算规则繁多,凭记忆手算既容易出错也无法复现;解读时以工具输出为唯一事实来源,不确定的细节回到输出中核对,而不是凭常识补写。
用法
TB 指本 skill 的根目录(加载 skill 时会告知):
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 用法错误。
选择工具
| 工具名 | 名称 | 用途 | 参数文档 | 解读指引 |
|---|---|---|---|---|
astrology | 西方占星命盘 | 根据出生信息计算本命盘与流运盘,输出基础坐标、命盘锚点、本命主星与流运触发 | references/astrology.md | interpretation/astrology.md |
bazi | 八字命盘 | 根据出生信息排四柱命盘,输出四柱干支、十神、藏干、地势、空亡与干支关系,可选输出纳音、神煞等扩展信息 | references/bazi.md | interpretation/bazi.md |
bazi_pillars_resolve | 四柱反推 | 根据四柱搜索分钟级出生时间区间,默认1900-2100,单次最多1200年 | references/bazi_pillars_resolve.md | interpretation/bazi.md |
ziwei | 紫微斗数命盘 | 根据出生信息计算紫微命盘,输出十二宫位、星曜分布、四化、大限等信息 | references/ziwei.md | interpretation/ziwei.md |
ziwei_horoscope | 紫微斗数运限 | 根据出生信息与目标日期计算大限、小限、流年、流月、流日、流时等运限信息 | references/ziwei_horoscope.md | interpretation/ziwei.md |
ziwei_flying_star | 紫微斗数飞星 | 按查询逐条分析命盘宫位的四化飞入、自化、四化落宫与三方四正 | references/ziwei_flying_star.md | interpretation/ziwei.md |
liuyao | 六爻排卦 | 根据问题与起卦信息排出六爻盘面,输出卦象、爻位、用神体系、关系判断与时机提示 | references/liuyao.md | interpretation/liuyao.md |
meihua | 梅花易数起卦 | 根据时间、字占、物数、报数等方式起卦,输出起卦信息、卦盘与体用推演 | references/meihua.md | interpretation/meihua.md |
tarot | 塔罗抽牌 | 按牌阵抽取塔罗牌,输出各牌位的牌面、正逆位、核心基调、元素与星象 | references/tarot.md | interpretation/tarot.md |
taiyi | 太乙排盘 | 支持九星观测,以及采用四库本金镜七十二局立成的现代历法适配年/月/日/时计 | references/taiyi.md | interpretation/taiyi.md |
almanac | 黄历查询 | 查询指定日期的黄历、宜忌、冲煞、值星、方位与时辰吉凶等信息 | references/almanac.md | interpretation/almanac.md |
bazi_dayun | 八字大运 | 根据出生信息计算起运时间与大运列表,可选输出起运前小运及各步大运的流年 | references/bazi_dayun.md | interpretation/bazi.md |
qimen | 奇门遁甲排盘 | 根据指定时间排出奇门盘,输出九宫、九星、八门、八神、格局等信息 | references/qimen.md | interpretation/qimen.md |
daliuren | 大六壬排盘 | 根据日期时间起课,输出天地盘、四课、三传、神将、课体与时空信息 | references/daliuren.md | interpretation/daliuren.md |
xiaoliuren | 小六壬占测 | 根据农历月日时辰起课,输出起课信息、推演链与结果信息 | references/xiaoliuren.md | interpretation/xiaoliuren.md |
调用前先 schema <tool>,或读 references/<tool>.md(参数表与可复制的示例)。
解读方法
排盘只是第一步。产出解读前,读工具表最后一列对应的 interpretation/<体系>.md——每份指引给出该体系的专家角色、流派技法与分析框架,按其组织解读内容。通用要求:
- 断语必须引用盘面证据(干支、星曜、爻位、格局名与工具输出逐字一致),不确定的回到输出核对。
- 正文以该体系术师的口吻写给问事人:先结论、后论证。工具调用与核验过程不写入正文,至多在文末一句带过——把篇幅留给卦理与判断,而不是操作记录。
- 关键事件给出时间范围、吉凶属性与影响程度;建议针对当前盘面,不写放之四海皆准的空话。
- 分析深度跟随用户要求伸缩:速断类(小六壬、单牌塔罗)短平快,命盘全局类(八字、紫微)分层展开,用户要求逐大限、逐流年时按指引调用运限工具补数据。
约定
- 历法:生辰类工具默认公历(
calendarType: "solar");用户给的是农历生日时改传"lunar",闰月再加isLeapMonth: true。xiaoliuren例外,直接接收农历月、日。 - 时间:
birthHour传 0-23 的钟表小时,早晚子时由引擎处理,不要自行折算时辰。xiaoliuren的hour可传时辰序号 1-12(子=1),也可传 0-23 小时。用户未提供的出生信息应当询问,而非代为假设。 - 占当下:
qimen、daliuren、liuyao与meihua的时间起卦需要当前时间时,先取系统时间(如date +"%Y-%m-%dT%H:%M:%S")再填入参数。 - 日期核实:用户说「今天/现在」并同时报出农历日期时,先取系统时间、用
almanac核对公农历对应——农历与公历的映射是查历数据,不能凭记忆换算。口述与核实不符时,指出差异并以核实结果起盘,必要时附口述日期的对照结果。出生生肖、未来日期干支也以 Core 对相应日期的计算为准,不能从公历年份或单日盘面补算。 - 随机性:
tarot可传seed复现抽牌;liuyao的method: "auto"每次结果随机,需要复现时改用select(指定卦名)或number(数字起卦)。 - 六爻用神:
yongShenTargets必填,按占问主题选择,可多选:事业官职、官司、疾病忧患取官鬼;财运、男问感情取妻财;文书合同、长辈、房产车辆取父母;子女晚辈、健康平安取子孙;合作竞争、朋友取兄弟。 - detailLevel:默认输出已够解读;需要完整盘面时在参数中加
"detailLevel": "full"(部分工具另有"more")。
其他接入方式
支持 MCP 的客户端可以不经本 skill,直接使用 npm 包 taibu-mcp(stdio)或公网端点 https://mcp.mingai.fun/mcp,工具集相同。