精确排盘（代码计算，非 LLM 推算）× 19 章深度分析 × 九部经典引用 × 历史校准实证 × 精美 HTML 报告
一个面向 AI Agent 的子平八字分析系统。排盘交给确定性代码，论命交给经典规则库，结论交给历史校准来验证——三层设计保证输出既专业又可被检验。
| 使用方式 | 支持程度 | 说明 |
|---|---|---|
| Claude Code（推荐） | 原生支持 | 克隆到 ~/.claude/skills/bazi-master，对话说"算八字"自动触发 |
| Codex CLI | 原生支持 | 克隆仓库后在仓库目录内启动 Codex，自动读取 AGENTS.md 加载本技能；联网步骤（lunardate 安装/节气查询/隧道分享）需批准网络权限 |
| 其他 AI Agent（Cursor / 自建 Agent） | 可移植 | 支持 AGENTS.md 的工具同上；否则把 SKILL.md 作为系统提示词喂入，工作流完全一致 |
| 不用 AI，纯命令行 | 部分支持 | scripts/paipan.py 是独立 Python 脚本，排盘功能可单独使用（无分析报告） |
# 独立排盘示例（无需任何 AI）
python3 scripts/paipan.py 2002 8 2 10 f
# 输出：壬午年 丁未月 壬寅日 乙巳时 + 十神/藏干/纳音/十二长生/大运1. 排盘必须是确定性计算。
日柱推算涉及公元纪日取模运算，月柱涉及节气换月，时柱涉及五鼠遁元——LLM 心算这些极易出错，而一个排错的盘会让后面所有分析全部作废。本 Skill 强制使用 paipan.py 计算（基准点 1900-01-01 = 甲戌日，已用 1949-10-01 = 甲子日交叉验证）。
2. 论命必须有典可依。 报告中每一个关键判断都标注经典出处（穷通宝典、滴天髓等），不允许 AI 凭"语感"下断语。分析框架的每一章都绑定了主引用典籍（见下文章节表）。
3. 结论必须可被验证。 采用《千里命稿》的实证方法论：报告最后一章会基于命局推导 3-5 件命主已经发生的事件（大运交接年的变动、流年冲合引动的节点、性格特征），请命主对照反馈。3/5 以上准确才视为排盘与用神判断成立，否则回头检查时辰。
本 Skill 的论命规则库提炼自以下九部命理经典，各司其职：
| 典籍 | 朝代/作者 | 在本 Skill 中的作用 | 核心引用示例 |
|---|---|---|---|
| 《穷通宝典》（造化元钥） | 清·余春台编 | 调候用神——按日干×生月查"命局药方"，每份报告第 2 章必用 | "十一月丙火，冬日之阳，取甲木为尊。甲透戊透，富贵双全" |
| 《滴天髓》 | 旧题宋·京图撰，清·任铁樵注 | 旺衰判断与气势流通——得令/得地/得势三要素，五行流通诊断 | "何知其人富，财气通门户。何知其人贵，官星有理会" |
| 《三命通会》 | 明·万民英 | 格局体系与神煞大全——八正格判定、天乙/文昌/桃花/羊刃等神煞起例 | "天乙贵人，甲戊庚牛羊，乙己鼠猴乡，丙丁猪鸡位" |
| 《子平真诠》 | 清·沈孝瞻 | 格局成败与用神专论——用神/相神/喜忌神体系，成格破格判断 | "格局以清纯为贵，杂浊为贱" |
| 《渊海子平》 | 宋·徐升编 | 四柱体系奠基——十神定义、六亲对应（偏财为父、正印为母、正财为妻） | "子午卯酉为四正之冲，冲力最大" |
| 《神峰通考》 | 明·张楠 | 病药说——命局有病方为贵，大运流年来药方有成；性格画像分析 | "七杀有制则为贵，制化得宜，其人有谋略、有胆识" |
| 《千里命稿》 | 民国·韦千里 | 实证断命方法论——宫位论法（年=祖上/月=父母/日=己身配偶/时=子女）、历史校准章的方法来源 | "论命当以事实为验。理论再精，不合实际则须反思" |
| 《协纪辨方书》 | 清·乾隆敕撰 | 神煞起例与吉凶权重——吉神逢克力减、凶神有制祸轻的判断原则 | "天德者，天之恩德也，入命则一生少凶险" |
| 《果老星宗》 | 旧题唐·张果 | 命宫推算（辅助参考）——星命体系交叉验证 | 寅上起月顺数至生时定命宫 |
经典规则的结构化摘要见 references/classical-texts.md，基础数表（十神推导、地支藏干、十二长生、刑冲合害、五鼠遁元、大运排法）见 references/ 目录其余文件。
每份报告为单文件自包含 HTML（移动端适配、可打印、可分享），章节与引用绑定如下：
| 章 | 标题 | 主引用 |
|---|---|---|
| 1 | 排盘总览（四柱/十神/纳音/地势） | 三命通会 |
| 2 | 调候用神（命局药方诊断） | 穷通宝典 ★必引 |
| 3 | 天干关系（合克链条） | 滴天髓 |
| 4 | 地支关系（刑冲合害破） | 渊海子平·三命通会 |
| 5 | 藏干透干 | 子平真诠 |
| 6 | 十二长生（生命力曲线） | 滴天髓 |
| 7 | 神煞 | 三命通会·协纪辨方书 |
| 8 | 五行力量与用神体系 | 穷通宝典·子平真诠 |
| 9 | 十神性格（四层人格画像） | 神峰通考 |
| 10 | 六亲详论 | 渊海子平 |
| 11-13 | 财运 / 事业 / 感情 | 滴天髓·穷通宝典·神峰通考 |
| 14 | 健康（附医学免责） | — |
| 15 | 大运逐步详解 | 子平真诠 |
| 16 | 流年逐月分析 | 穷通宝典 |
| 17 | 转运建议（方位/颜色/社交） | — |
| 18 | 命盘核心叙事（人生三幕） | 滴天髓 |
| 19 | 历史校准验证 | 千里命稿 ★特色 |
完整样例见 templates/report-example.html。
另支持合婚配对：日主配对 / 五行互补（调候互补为最高权重）/ 地支关系 / 十神互看 / 大运同步，五维评分。
详细操作指南（安装步骤、使用流程、FAQ、已知精度限制）见 USAGE.md，可打印的 PDF 版见 usage-guide.pdf（含每步耗时与验收标准）。
快速安装（Claude Code）：
mkdir -p ~/.claude/skills
git clone https://github.com/secret04725-coder/bazi-master-skill.git ~/.claude/skills/bazi-master
pip3 install lunardate # 农历转换依赖之后在 Claude Code 对话中说"算八字"即可触发。支持农历自动转换、真太阳时校正、夜子时换日、合婚配对、Cloudflare 隧道一键分享。
bazi-master-skill/
├── SKILL.md # Skill 入口 / 系统提示词（Claude Code 自动识别）
├── USAGE.md # 详细使用操作指南
├── scripts/
│ └── paipan.py # 精确排盘计算器（可独立使用）
├── references/
│ ├── classical-texts.md # 九部经典核心论命规则摘要
│ ├── dayun-rules.md # 大运顺逆排法与起运年龄
│ ├── shichen-table.md # 时辰对照表 / 五鼠遁元 / 早晚子时
│ └── wuxing-tables.md # 十神推导 / 地支藏干 / 十二长生 / 刑冲合害
└── templates/
├── report-example.html # 完整19章报告样例（生成基准）
└── report-style.css # CSS 组件清单与五行配色方案
| 特性 | 本 Skill | 纯 LLM 推算 |
|---|---|---|
| 排盘方式 | Python 确定性计算，可交叉验证 | LLM 心算，日柱极易出错 |
| 调候用神 | 穷通宝典逐月查表，每报必析 | 常被遗漏 |
| 经典引用 | 每个关键判断标注出处 | 无出处，凭语感 |
| 结论验证 | 历史校准章，命主可证伪 | 不可验证 |
| 输出 | 19 章可视化 HTML 报告 | 纯文本 |
| 农历/真太阳时/夜子时 | 内置处理规则 | 通常忽略 |
- 脚本节气采用近似日期，节气日 ±2 天出生需联网核实真实节气时刻（SKILL.md 已内置该规则）
- 起运年龄默认 9 岁近似，精确值需按节气天数÷3 重算（大运干支序列本身准确）
- 真太阳时校正依赖出生地经度，边界时辰（±30 分钟）建议双版本对照
命理分析属传统文化研究与参考体系，本项目旨在以工程化方法整理古典命理文献的推理规则，不构成医疗、投资、婚姻等任何现实决策依据。健康相关内容请以医学诊断为准。