taibu-divination

hhszzzz/taibu · Agent Skill

Provides 15 calculation engines for Chinese metaphysics, including BaZi, ZiWei DouShu, Tarot, and Western astrology, for divination and chart analysis.

Jump to install ↓

Install options

The review-first prompt is selected by default. You can switch to a direct command.

Install with Claude or Codex

Copy the prompt, paste it into Claude, Codex, or another assistant, and it will review the skill page and install it.

I'd like to install this Claude Code skill:
https://github.com/hhszzzz/taibu/tree/master/skills/taibu-divination

Please review the SKILL.md file, verify the skill is legitimate, then copy the skill folder into .claude/skills/ of my project.

Review the source files

25 files Download Zip

Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.

SKILL.md contents

Original author text · read-only

太卜占术工具

太卜提供 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 用法错误。

选择工具

<!-- TOOLS:BEGIN -->

| 工具名 | 名称 | 用途 | 参数文档 | 解读指引 |

| --- | --- | --- | --- | --- |

| astrology | 西方占星命盘 | 根据出生信息计算本命盘与流运盘,输出基础坐标、命盘锚点、本命主星与流运触发 | references/astrology.md | interpretation/astrology.md |

| bazi | 八字命盘 | 根据出生信息计算四柱命盘,输出天干地支、十神、藏干、神煞、关系格局等信息 | references/bazi.md | interpretation/bazi.md |

| bazi_pillars_resolve | 四柱反推 | 根据年柱、月柱、日柱、时柱反推出生时间候选列表 | 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 |

<!-- TOOLS:END -->

调用前先 schema <tool>,或读 references/<tool>.md(参数表与可复制的示例)。

解读方法

排盘只是第一步。产出解读前,读工具表最后一列对应的 interpretation/<体系>.md——每份指引给出该体系的专家角色、流派技法与分析框架,按其组织解读内容。通用要求:

  • 断语必须引用盘面证据(干支、星曜、爻位、格局名与工具输出逐字一致),不确定的回到输出核对。
  • 正文以该体系术师的口吻写给问事人:先结论、后论证。工具调用与核验过程不写入正文,至多在文末一句带过——把篇幅留给卦理与判断,而不是操作记录。
  • 关键事件给出时间范围、吉凶属性与影响程度;建议针对当前盘面,不写放之四海皆准的空话。
  • 分析深度跟随用户要求伸缩:速断类(小六壬、单牌塔罗)短平快,命盘全局类(八字、紫微)分层展开,用户要求逐大限、逐流年时按指引调用运限工具补数据。

约定

  • 历法:生辰类工具默认公历(calendarType: "solar");用户给的是农历生日时改传 "lunar",闰月再加 isLeapMonth: truexiaoliuren 例外,直接接收农历月、日。
  • 时间birthHour 传 0-23 的钟表小时,早晚子时由引擎处理,不要自行折算时辰。xiaoliurenhour 可传时辰序号 1-12(子=1),也可传 0-23 小时。用户未提供的出生信息应当询问,而非代为假设。
  • 占当下qimendaliurenliuyaomeihua 的时间起卦需要当前时间时,先取系统时间(如 date +"%Y-%m-%dT%H:%M:%S")再填入参数。
  • 日期核实:用户说「今天/现在」并同时报出农历日期时,先取系统时间、用 almanac 核对公农历对应——农历与公历的映射是查历数据,不能凭记忆换算。口述与核实不符时,指出差异并以核实结果起盘,必要时附口述日期的对照结果。
  • 随机性tarot 可传 seed 复现抽牌;liuyaomethod: "auto" 每次结果随机,需要复现时改用 select(指定卦名)或 number(数字起卦)。
  • 六爻用神yongShenTargets 必填,按占问主题选择,可多选:事业官职、官司、疾病忧患取 官鬼;财运、男问感情取 妻财;文书合同、长辈、房产车辆取 父母;子女晚辈、健康平安取 子孙;合作竞争、朋友取 兄弟
  • detailLevel:默认输出已够解读;需要完整盘面时在参数中加 "detailLevel": "full"(部分工具另有 "more")。

其他接入方式

支持 MCP 的客户端可以不经本 skill,直接使用 npm 包 taibu-mcp(stdio)或公网端点 https://mcp.mingai.fun/mcp,工具集相同。