AI 八字 + 紫微斗数 Skill

一个遵循 SKILL.md 开放标准的命理分析 Skill,可装入 Claude Code / Claude Desktop / Codex / Cursor / Hermes / OpenClaw 等支持该标准的 AI Agent。

它做三件大模型单独做不好的事:

1. **精准排盘**:八字四柱、紫微十二宫、大运流年由内置算法库计算,不让 LLM 自己排——纯 LLM 排盘常把日柱、日主、格局算错,一步错则全盘失真。
2. **格局补层**:在排盘之上补一层"格局 / 旺衰 / 调候 / 刑冲合害 / 盖头截脚"算法,喂给 LLM 做有依据的分析。
3. **综合印证**:把八字与紫微两套独立体系的结论做交叉对账——主轴是否一致、人生窗口是否对齐、冲突时听谁。

**特性:**
- 🎯 算法精准:排盘核心源自开源项目 Yiqi(MIT),经实测对齐;补层算法经 7 组案例多维度回归验证
- 🧭 三种分析模式:八字独立 / 紫微独立 / 八字+紫微综合印证
- 📜 两种呈现形态:Markdown 长文深度版 + 🎴 单文件 HTML 海报版(综合印证专属)
- 🎴 水墨风命盘海报:现代极简 × 中式水墨,含紫微 12 宫盘 + 八字四柱盘 + 六维交叉对账
- 🔌 跨 Agent:一份 SKILL.md,多个主流 Agent 通用
- 🔒 隐私优先:所有排盘在本地完成,无需联网

安装

1. 克隆仓库

git clone https://github.com/Selei1983/bazi-ziwei-skill.git

2. 安装算法层依赖

cd bazi-ziwei-skill/calculator
npm install

需要 Node.js >= 18。算法层依赖仅一个:lunar-typescript(MIT)。

3. 注册到 Agent

把整个 bazi-ziwei-skill/ 文件夹放进 Agent 的 skills 目录:

Agent 会自动读取 SKILL.md 并按需调用。

使用

装好后,直接对 Agent 说出生时间即可:

我是 2000 年 1 月 1 日中午 12 点出生的男生,帮我看下命盘。

Agent 会:
1. 问你要哪种分析(八字 / 紫微 / 综合印证)
2. 综合印证时再问要长文还是 HTML 海报
3. 调用算法层排盘 → 加载对应提示词 → 输出分析或渲染海报

命令行直接排盘(不经 Agent)

cd calculator
# 排盘 → JSON
node dist/run-chart.js --year=2000 --month=1 --day=1 --hour=12 --minute=0 --gender=male > chart.json

# JSON → 可读文本盘
node dist/dump-text.js --input=chart.json --output=chart.txt

# JSON + 分析 JSON + 模板 → HTML 海报
node dist/render.js --chart=chart.json --analysis=analysis.json \
  --template=../templates/report-zonghe-poster.html --output=report.html --currentYear=2026

仓库自带合成示例(2000-01-01 男,非真人)

• examples/sample-chart.json — 算法层排盘输出
• examples/sample-chart.txt — 文墨天机风文本盘
• examples/sample-analysis.json — 综合印证分析(示例)
• examples/sample-report.html — 综合印证海报成品,下载后用浏览器打开即可预览效果