bazi-skill：赛博算命 Skill 技术分析

来源：https://github.com/jinchenma94/bazi-skill
整理时间：2026-04-11
标签：#Skill #八字 #命理 #四柱排盘 #AI算命 #MiniMax #推演解耦

一、项目概述

bazi-skill 是一个四柱八字命理分析 Skill，属于 MiniMax Skills 生态（colleague-skill Gallery）。

根据出生信息与传统命理典籍进行四柱排盘与分析，用结构化方式呈现八字命盘，结合五行生克、大运流年进行解读。

GitHub： https://github.com/jinchenma94/bazi-skill

二、文件结构

bazi-skill/
├── SKILL.md                    # Skill 入口
├── references/
│   ├── wuxing-tables.md        # 五行、天干地支、十神参考表
│   ├── shichen-table.md         # 时辰对照表、日上起时法
│   ├── dayun-rules.md           # 大运顺逆排规则、起运年龄计算
│   └── classical-texts.md       # 九本经典典籍核心规则摘要
├── LICENSE
└── README.md

三、核心能力

四、技术设计亮点

4.1 推演解耦架构（来自 gaoxin492/bazi-skill）

该项目有一个更详细的 fork 版本，揭示了更完整的技术架构：

┌─────────────────────────────────────────────────────┐
│                   计算层 (Python)                    │
│  ・历法转换（阳历↔阴历）                              │
│  ・出生地真太阳时校正                                 │
│  ・五行生克计算                                      │
│  ・干支排盘                                          │
│  模型不手算四柱，从根本上消灭排盘幻觉                   │
└─────────────────────────────────────────────────────┘
                          ↓ JSON 结构化输出
┌─────────────────────────────────────────────────────┐
│                   结构层 (JSON)                      │
│  底层脚本输出纯结构化数据给大模型作为隐式上下文           │
│  确保流转数据严谨稳定                                  │
└─────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────┐
│                   大模型 (LLM)                       │
│  基于 JSON 隐式上下文进行命理深度分析                   │
└─────────────────────────────────────────────────────┘

关键设计原则：
- 计算归计算，推理归推理
- Python 处理确定性运算（历法、干支、五行生克）
- LLM 只做需要理解的分析和解读

4.2 参考资料体系

references/
├── wuxing-tables.md     → 五行、天干地支、十神查表
├── shichen-table.md     → 时辰对照、日上起时法
├── dayun-rules.md       → 大运顺逆排规则、起运年龄
├── classical-texts.md   → 九本经典典籍核心摘要

这些参考文件是 AI 准确解读命理知识的知识库（RAG 资料）。

4.3 本地存档机制

~/.bazi_skill/profiles/

自动把命理对象归档留存，方便后续查询和对比分析。

五、关键技术细节

5.1 真太阳时校正

八字排盘需要精确到时辰，而中国统一使用北京时间，但实际出生地可能不在东八区。

真太阳时公式：

真太阳时 = 平太阳时 + 真太阳时差
真太阳时差 = 当地经度 - 120° × 4分钟

5.2 干支排盘规则

5.3 大运计算规则

• 阳年生人顺排，阴年生人逆排
• 起运年龄：按性别和出生季节计算

六、开发借鉴价值

6.1 “推演解耦”模式

这是最值得学习的架构设计：

传统方式：
LLM → 直接做排盘计算 → 幻觉频发、准确性差

bazi-skill 方式：
LLM（规划/调度）→ Python（精确计算）→ LLM（分析解读）→ 结构化输出

适用场景： 任何需要”确定性计算 + 不确定性推理”混合的任务

6.2 参考资料即知识库

Skill 的 references/ 目录本质是一个垂直领域知识库：
- 人工整理/AI辅助整理的权威资料
- 格式化为 Markdown 供 LLM 上下文理解
- 相比让 LLM”背书”，这种方式更可控

6.3 JSON 作为中间协议

Python 计算结果 → JSON → LLM 隐式上下文

好处：
- 计算精确性有保障
- LLM 只看到它需要的数据
- 结构化数据比纯文本更少歧义

七、与 MiniMax Skills 生态的关系

bazi-skill 属于 colleague-skill Gallery（社区 Skill 画廊）：

用户可以通过 npx skills add 安装这些 Skill：

npx skills add jinchenma94/bazi-skill -y -g

八、一句话总结

bazi-skill = 推演解耦 + 垂直知识库 + JSON 中间协议，让 AI 算命从”LLM 瞎猜”变成”Python 精确计算 + LLM 智能解读”。

九、相关链接

本文由 AI 辅助整理，供技术学习参考。