---
name: bazi-full-fortune
description: >
  八字全方位算命 Skill — 排盘引擎 + 六亲十神规则 + 家庭校准 + 回测校验 + 八大维度
  全方位分析模板。当用户提到八字、四柱、四柱八字、天干地支、日主、十神、大运流年、
  喜用神、忌神、格局、身强身弱、五行旺衰、伤官配印、食神生财、排盘、反推阳历、
  查黄历、命局分析等相关内容，或想了解命运、性格、事业、婚姻、财运、健康、学业
  且明确要求或暗示使用八字体系时，触发此技能。支持可选的紫微斗数交叉验证以提升
  结论稳定性。
tags: [bazi, fortune-telling, chinese-astrology, destiny-analysis, four-pillars]
---

# 八字全方位算命 Skill

## 项目定位

本项目是一个完整的八字命理工作流工具集，包含：

1. **排盘层** — 基于 `cantian-tymext` 的 CLI 脚本，支持阳历/农历输入，输出完整四柱、十神、神煞、大运、刑冲合会
2. **分析层** — 全方位命理解读模板，覆盖家庭、健康、事业、财富、感情、人际、学业、精神八大维度
3. **参考层** — 六亲十神规则、分析指南、家庭模式速查、易错点 + 十日主喜忌

## 何时使用

- 用户要根据阳历/农历出生时间计算四柱八字
- 用户要「全方位分析这个八字」或「帮我全面分析八字」
- 用户要查询某一天对应的农历、干支、宜忌等信息
- 用户要「查黄历」或看某天宜忌
- 用户给出已知四柱干支要求反推阳历日期

## 核心规则

### 解释边界

- 命盘展示的是倾向、结构与课题机会，不是绝对命定。
- 不用恐吓式、宿命式表述，不说「注定如此」「无法改变」。
- 健康、法律、财务等问题只做命盘角度的结构提醒，不替代医生、律师、财务顾问等现实专业意见。
- 结论要有推演依据，尽量体现推演过程；不只说好听的话，也不刻意吓人，保持客观平衡。

### 逻辑优先级

1. 先确认出生信息与口径（公历/农历、闰月、早晚子时）
2. 再调用脚本严格排盘，不心算排盘
3. 再做日主强弱、格局、十神、喜用忌分析
4. 经验口诀与实际排盘推演冲突时，以推演结果为准

### 默认口径

- 早晚子时：默认 `sect=2`（23:00-23:59 算当日）。用户有既定口径时优先沿用并说明差异。
- 农历闰月：`buildBaziFromLunar.ts` 不支持闰月。排盘前必须先问清是否闰月；闰月用 tyme4ts 的 `LunarDay` 负月号转阳历后再排（见第 7 节），禁止默认按普通月份排。

### 询问优先

- 信息不全先追问，不硬排；优先问会直接改变盘面的信息（公历/农历、闰月、出生时间、性别）。
- 出生时间模糊（只知「上午」「傍晚」）时，在结论中标注不确定性，并提供「双时辰对比」方案：按两个候选时辰分别排盘对比，看哪个更贴合实际再确定。
- 用户已有可信排盘软件结果或现成命盘时，优先校盘（核对四柱、大运顺逆、起运岁数）再解读，避免重复换算带来口径偏差。

## 前置依赖

- 推荐运行环境：Node 24（可直接运行 TypeScript 源码）
- 兼容方案：若 Node 版本较低，使用 `tsx` 执行

```bash
npm install

# 仅在需要兼容运行时安装
# npm install -D tsx
```

---

# 〇、使用指南

## 1. 排盘

阳历排盘：

```bash
node scripts/buildBaziFromSolar.ts "2000-12-22T03:30:00" 0 2
```

| 参数 | 说明 | 必填 | 取值 |
|------|------|------|------|
| solarTime | 阳历出生时间（ISO 8601，不带时区） | 是 | `2000-12-22T03:30:00` |
| gender | 性别 | 否 | `1`=男，`0`=女（默认 1） |
| sect | 早晚子时配置 | 否 | `1`=23:00-23:59 算次日，`2`=算当日（默认 2） |

农历排盘：

```bash
node scripts/buildBaziFromLunar.ts "2000-11-27T03:30:00" 0 2
```

参数格式与阳历一致，时间传入农历日期。注意：不支持农历闰月，闰月需先手动转换为阳历再调用阳历排盘。

## 2. 黄历查询

```bash
# 查询今天
node scripts/getChineseCalendar.ts

# 查询指定日期
node scripts/getChineseCalendar.ts 2024-02-10
```

## 3. 反推扫描

从已知八字四柱反查阳历出生日期：

```bash
# 完整四柱匹配
node scripts/scan_year.ts 2000 0 \
  --year-pillar 庚辰 \
  --month-pillar 戊子 \
  --day-pillar 甲寅 \
  --hour-pillar 丙寅 \
  --hour 03:30:00

# 部分匹配（只知道年月日柱，时柱不确定）
node scripts/scan_year.ts 2000 0 \
  --year-pillar 庚辰 \
  --month-pillar 戊子 \
  --day-pillar 甲寅

# 跨年份扫描（同一八字每 60 年重复出现）
for y in 1940 2000; do node scripts/scan_year.ts $y 0 --day-pillar 甲寅; done
```

| 参数 | 说明 |
|------|------|
| year | 要扫描的年份（必填） |
| gender | 0=女，1=男（必填） |
| --year-pillar | 年柱过滤（如 庚辰） |
| --month-pillar | 月柱过滤（如 戊子） |
| --day-pillar | 日柱过滤（如 甲寅） |
| --hour-pillar | 时柱过滤（如 丙寅） |
| --hour | 扫描用的时间，默认 15:30:00（申时） |

### 时柱与时间对应表

| 时辰 | 时间段 | 示例 |
|------|--------|------|
| 子 | 23:00-00:59 | T23:30 |
| 丑 | 01:00-02:59 | T01:30 |
| 寅 | 03:00-04:59 | T03:30 |
| 卯 | 05:00-06:59 | T05:30 |
| 辰 | 07:00-08:59 | T07:30 |
| 巳 | 09:00-10:59 | T09:30 |
| 午 | 11:00-12:59 | T11:30 |
| 未 | 13:00-14:59 | T13:30 |
| 申 | 15:00-16:59 | T15:30 |
| 酉 | 17:00-18:59 | T17:30 |
| 戌 | 19:00-20:59 | T19:30 |
| 亥 | 21:00-22:59 | T21:30 |

### 反推逻辑

1. 年柱推年份（干支纪年，如丁丑=1997，每60年一轮）
2. 月柱推农历月份范围
3. 在缩小的月份范围内用 `scan_year.ts` 扫描匹配日柱
4. 验证时柱是否正确

## 4. npm scripts 快捷方式

```bash
npm run bazi:solar -- "2000-12-22T03:30:00" 0 2
npm run bazi:lunar -- "2000-11-27T03:30:00" 0 2
npm run calendar
npm run calendar -- 2024-02-10
npm run scan -- 2000 0 --day-pillar 甲寅 --hour 03:30:00
```

## 5. 作为 AI Agent 技能使用

安装后，AI Agent 会自动加载此技能。直接对 Agent 说话即可触发：

排盘：

```
帮我排一下八字：2000年12月22日凌晨3点半，女
```

全方位分析：

```
庚辰 戊子 甲寅 丙寅 女 2000年生人，帮我全方位分析
```

Agent 会自动：
1. 调用排盘脚本获取完整数据（四柱、十神、神煞、大运、刑冲合会）
2. 先基于纯八字给出温和的家庭/父母/自身阶段初判
3. 再向你提出 5 个校准问题（父母关系、父亲驻地、母亲角色、家庭经济、自身状态）
4. 根据你的回答校准分析，并做回测校验（用近一两年实际顺逆与已发生事件反校验身强身弱与喜用假设）
5. 询问是否需要紫微斗数交叉验证（默认不启用；如需要，按 `references/ziwei/` 规则排紫微盘并交叉验证）
6. 按八大维度模板输出完整解读报告

反推阳历：

```
庚辰 戊子 甲寅 丙寅，女命，帮我反推一下阳历出生日期
```

查黄历：

```
帮我查一下今天的黄历
帮我查一下 2024-02-10 的农历和宜忌
```

## 6. 完整分析工作流

如果你想手动走完整流程，步骤如下：

第一步：确认命造信息（先访谈，再排盘）

1. 出生日期是公历还是农历？农历需问清是否闰月（闰月不能默排，见第 7 节）
2. 出生时间精确到分钟，或至少到时辰
3. 性别（影响大运顺逆）
4. 出生地（涉及时辰交界校正时可能需要）
5. 是否已有现成排盘结果（有的话优先校盘，核对四柱、大运顺逆与起运岁数）

访谈问题库见 `references/interview.md`。

第二步：排盘

```bash
node scripts/buildBaziFromSolar.ts "2000-12-22T03:30:00" 0 2
```

输出包含：四柱天干地支、十神、纳音、星运、自坐、藏干、宫位、神煞、大运、刑冲合会。

排盘自检：

- 年干阴阳与大运顺逆方向一致（阳年男/阴年女顺排，阴年男/阳年女逆排）
- 月支对应正确节气（以节气为界换月，不是农历初一）
- 起运岁数必须取自脚本输出，严禁手估
- 十神推算无误

第三步：家庭校准（先给纯八字初判，再向用户确认 5 个事实）

先根据父母星、父母宫/月柱、刑冲合害、当前大运，温和写出 3-5 条初判；再按以下问题让用户校验：

1. 父母是否在一起？（离婚 / 一方缺席 / 双全 / 聚少离多但未分开）
2. 父亲做什么工作？常驻地在哪里？
3. 母亲在带你吗？还是由其他长辈带大？
4. 家里做什么的？（开店/体制内/务农/外出务工/其他）
5. 你目前在做什么？（学业/工作/哪个阶段）

注意：家庭敏感判断要用「倾向」「可能」「关系压力」「聚少离多」「在场感偏弱」等表达，不要用「必离」「克父母」「父母感情很差」这类激烈断语。用户反馈不符时，以用户事实为准校准。

详见 `references/analysis-guide.md` 第一章。

第四步：回测校验——先给出身强身弱与喜用神的初步假设，请用户用近一两年实际顺逆（忌神年是否难受、喜用月是否得财）及 2-3 个已发生的关键事件反校验。假设与事实不符时，先回查排盘口径与判断依据，校准后再输出完整报告。

分析逻辑方法论（填充输出模板前，先按此框架完成推演）

方法论管「怎么分析」，「全方位分析输出模板」管「输出长什么样」——先按以下五步推演出结论，再把结论填进模板对应维度。

1. 日主强弱四维法：①令——日主生于何月，是否当令；②地——日主在地支是否有根（通根、余气，日主坐禄/临官为强根）；③势——印比多则强，食伤/财/官多则弱；④综合——身强/身弱/从格判定。强调：四项综合权衡，不可只看月令失令就断身弱。
2. 格局与喜用神：判断格局类型（正格 / 特殊格局）→ 定喜用神与忌神 → 必须写明判断依据。
3. 十神配置分析顺序：性格与思维方式 → 事业方向与财运模式 → 婚姻感情与家庭 → 健康隐患。
4. 大运流年推演顺序：先说本命盘底色 → 再说当前大运主题 → 最后说流年触发点；重点标注「已发生事件」的年份方便校验；尽量具体到年龄段及年份范围，并说明为什么会在那个阶段出现。
5. 总结四要素：命局核心特点 / 一生最需注意的风险点 / 最值得把握的发展方向 / 特别关键的年份阶段。

五行力量的定量核算见 `references/analysis-guide.md` 第二章加权计算（作为「地」「势」两维的量化工具）。

第五步（可选）：紫微斗数交叉验证——询问用户是否需要，默认不启用。

- 触发方式：明确询问「是否需要用紫微斗数对你的八字结论做交叉验证？」；用户未主动要求且未确认时不启用。
- 排盘方式：按 `references/ziwei/calculation.md` 规则排盘（命宫身宫十二宫、五行局、十四主星、四化、大限）。排盘前必须声明口径：默认三合派；闰月归属默认「闰月按下月」并明确告知用户（此为紫微排盘口径，与本项目八字排盘的闰月转换口径分开说明）；用户有既定口径时优先沿用。安紫微星可用 `python3 scripts/ziwei_verify.py` 校验。
- 交叉验证规则：两体系各自按自身逻辑独立分析，不混用术语；同维度结论一致则标注「双体系一致，结论稳定性提升」；不一致则回查各自排盘口径（重点查闰月与子时换日），不强行调和。
- 验证维度：性格、事业、财运、感情、健康五个维度逐项比对。
- 输出：在八字报告后附加「紫微交叉验证结论」一节，简明列出一致项 / 分歧项 / 口径说明。

第六步：根据排盘数据 + 校准信息，按「全方位分析输出模板」填充分析报告。分析时参考：
- `references/bazi-fundamentals.md` — 六亲十神对应规则、十日主特性与喜忌
- `references/analysis-guide.md` — 分析要点 + 校准工作流
- `references/pitfalls.md` — 易错点 + 十日主喜忌速查
- `references/family-patterns.md` — 家庭背景命理模式速查

第七步：输出为 txt 文件，文件名格式 `八字全解_日主X_生肖X.txt`，文末附温馨提示（见「四、结尾提醒」）。

## 7. 农历闰月处理

`buildBaziFromLunar.ts` 不支持闰月。处理流程：

1. 用 `tyme4ts` 构造闰月农历日，获取对应阳历：
```javascript
import { LunarDay } from 'tyme4ts';
const solarDay = LunarDay.fromYmd(1998, -5, 13).getSolarDay();
// 负月号 = 闰月，如 -5 表示闰五月
```

2. 用得到的阳历日期调用 `buildBaziFromSolar.ts`

---

# 一、全方位分析输出模板

## 输出要求

1. 先跑排盘脚本获取数据
2. 如需校准，先向用户提问
3. 按以下模板生成 txt 文件
4. 文件名格式：`八字全解_日主X_生肖X.txt`

## 模板

```
---

全方位命理解读

八字：[年柱] [月柱] [日柱] [时柱]
日主：[日干]（[阴阳][五行]）
生肖：[生肖]
纳音：[纳音]命
性别：[男/女]

六亲十神对照（[男/女]命[日干]日主）：
- [逐一列出所有六亲对应的十神]
- 对原命局中完全不见的十神，标注"— 原命局完全不见（四柱藏干均无X）"

五行分布：
- 天干：[逐一列出]
- 地支：[逐一列出]
- 藏干主气：[逐一列出]
- 藏干中气：[逐一列出]
- 藏干余气：[逐一列出]

十神完整清单：
- 有：[列出所有存在的十神及其位置和权重]
- 完全不见：[列出四柱天干、地支、所有藏干中均不存在的十神]

格局概览：
- [基于脚本输出的星运、自坐、藏干综合分析]
- [用神判断]

核心特征：
- [3-5个核心特征，带权重计算]

---

👨‍👩‍👧 家庭

父亲
- 男命看偏财，女命看正财（[位置]）
- [根据十神、地支、藏干分析父亲性格和能力]
- [父亲与命主的关系：刑冲合会]
- [父亲对命主的影响]
- 💡 建议：[针对父子/父女关系的建议]

母亲
- 男命看正印，女命看偏印（枭神）——[位置]
- [根据十神、地支、藏干分析母亲性格]
- [母亲与命主的关系]
- [母亲对命主的影响]
- 💡 建议：[针对母子/母女关系的建议]

兄弟姐妹
- [比肩/劫财分析同辈关系]
- [数量和关系质量]

家庭整体
- [家境分析：月柱冠带/临官等]
- [父母关系]
- [童年氛围]
- [成年后与家庭的关系走向]

---

🏥 健康

五行对应脏腑
🌳 木
• 脏腑: 肝胆
• 强弱: [根据排盘判断]
• 状况: [具体表现]

🔥 火
• 脏腑: 心脏、眼睛
• 强弱: [根据排盘判断]
• 状况: [具体表现]

🌍 土
• 脏腑: 脾胃
• 强弱: [根据排盘判断]
• 状况: [具体表现]

🪙 金
• 脏腑: 肺、大肠、皮肤
• 强弱: [根据排盘判断]
• 状况: [具体表现]

💧 水
• 脏腑: 肾、膀胱、生殖
• 强弱: [根据排盘判断]
• 状况: [具体表现]

重点健康问题
1. [根据五行过旺/过弱/刑冲分析的第1个问题]
2. [第2个问题]
3. [第3个问题]
4. [第4个问题]
5. [第5个问题]

健康养生建议
- ✅ [建议1]
- ✅ [建议2]
- ✅ [建议3]
- ✅ [建议4]
- ⚠️ [注意事项]

---

👤 外貌身材

整体气质
[日主五行对应的气质描述]

- 身形：[骨架、体态]
- 脸型：[脸型特征]
- 眉眼：[眉眼特征]
- 鼻梁：[鼻型]
- 皮肤：[肤色肤质]
- 头发：[发质发量]
- 声音：[声音特征]

气质加分项
- [神煞对外貌的影响]
- [十神组合对气质的影响]

身材走势
- [大运名称]（[起止年份]）：[描述]
- [大运名称]（[起止年份]）：[描述]
- [大运名称]（[起止年份]）：[描述]
- 💡 当前阶段的建议

穿着风格
- 适合：[风格建议]
- 不适合：[避免的风格]
- 颜色：[喜用五行对应颜色]
- 避免：[忌神五行对应颜色]
- 小配饰加分：[饰品建议]

---

💼 事业

事业格局
[十神组合判断事业类型]

- [事业特点1]
- [事业特点2]
- [事业特点3]
- [事业特点4]

适合行业（按喜用五行排序）
🪙 金
• 行业: [具体行业]
• 适配度: [星级]

🔥 火
• 行业: [具体行业]
• 适配度: [星级]

🌍 土
• 行业: [具体行业]
• 适配度: [星级]

🌳 木
• 行业: [具体行业]
• 适配度: [星级]

💧 水
• 行业: [具体行业]
• 适配度: [星级]

事业时间线（用实际年份，不用岁数，避免虚实岁混淆）

[大运名称]（[起止年份]）
• 阶段: [关键词]
• 关键词: [描述]

[大运名称]（[起止年份]）
• 阶段: [关键词]
• 关键词: [描述]

[大运名称]（[起止年份]）
• 阶段: [关键词]
• 关键词: [描述]

[大运名称]（[起止年份]）
• 阶段: [关键词]
• 关键词: [描述]

[大运名称]（[起止年份]）
• 阶段: [关键词]
• 关键词: [描述]

与领导/同事关系
- [与上司的关系模式]
- [容易遇到的类型]
- [职场人际建议]
- ✅ [合作贵人特征]

---

💰 财富

财运格局
- [财星分析：正财/偏财哪个旺]
- [赚钱模式]
- [财运特征]

财富等级预估
- 走对路：[描述]
- 走错路：[描述]
- 保险策略：[建议]

破财年份（重点记）
- ⚠️ [年份1]：[原因]
- ⚠️ [年份2]：[原因]
- ⚠️ [年份3]：[原因]

偏财 vs 正财
- 偏财：[适合的赚钱方式]
- 正财：[适合的赚钱方式]
- [命主的财运偏向]
- 💡 建议：[理财建议]

理财避坑
- ❌ [不要做的事1]
- ❌ [不要做的事2]
- ❌ [不要做的事3]
- ✅ [应该做的事1]
- ✅ [应该做的事2]

---

💕 感情婚姻

[男命：妻子画像 / 女命：丈夫画像]
- [配偶星位置分析]
- [配偶性格特征]
- [配偶外貌特征]
- [配偶职业/年龄倾向]

感情模式
- [感情特点1]
- [感情特点2]
- [感情特点3]
- [典型感情过程]

婚配建议
- 宜配生肖：[三合/六合生肖]
- 次配：[其他合适生肖]
- ⚠️ 慎配：[相冲/相害生肖]
- 配偶方位：[喜用神对应方位]
- 职业上：[适合的配偶职业类型]

婚期最佳年
- ✨ [年份1]（[原因]，最推荐）
- ✨ [年份2]（[原因]，第二选择）
- 🟢 [其他可选年份]
- ⛔️ 避开 [不利的年份]

感情避坑
- ❌ [不要做的事]
- ❌ [不要做的事]
- ✅ [应该做的事]
- ✅ [应该做的事]

---

👥 人际关系

朋友圈
- [比肩/劫财分析交友特点]
- [朋友数量和质量]
- [社交风格]

贵人运
- [贵人神煞分析]
- 贵人类型：[描述]
- 贵人属相：[生肖]
- 贵人方位：[方位]
- 💡 [如何吸引贵人]

小人运
- [小人出现的时期]
- 小人类型：[描述]
- ⚠️ [防小人建议]

---

📚 学业

读书运
- [印星分析学业]
- [考试运]
- [思维特点]
- [适合的研究方向]

学历预估
- [正常路线]
- [学术路线]
- [潜在障碍]

学习风格
- [学习方式偏好]
- [动力来源]
- 💡 建议：[学习方法建议]

---

🧘 精神世界

[神煞分析精神层面]
- [灵性/直觉特点]
- [内心世界的矛盾]
- [艺术/创作天赋]

内心世界
- 表面：[外在表现]
- 内心：[内在真实状态]
- [独处时的状态]
- 💡 建议：[精神出口建议]

信仰建议
- [适合的信仰方向]
- [适合的修行方式]
- [可能接触玄学的时期]

---

[对应生肖emoji] 综合特质 · 一句话总结

生肖 emoji 对照：鼠🐭 牛🐮 虎🐯 兔🐰 龙🐲 蛇🐍 马🐴 羊🐑 猴🐒 鸡🐔 狗🐶 猪🐷

[用一句话概括整个命盘的核心特质和人生走向]

[2-3句话总结人生节奏和关键转折点]
```

---

# 二、参考文档

| 文档 | 内容 |
|------|------|
| `references/bazi-fundamentals.md` | 理论基础（天干地支、五行生克、身强身弱、十神详解、六亲对应、刑冲合害破、神煞、格局、用神取法、大运流年、十日主特性与喜忌） |
| `references/analysis-guide.md` | 实战方法（校准工作流、五行加权计算、十神完整清单、大运十神、输出格式规则） |
| `references/pitfalls.md` | 分析易错点速查（10条 ❌→✅） |
| `references/family-patterns.md` | 家庭背景命理模式速查（9种模式的信号→推断→校准问题） |
| `references/dev-ops.md` | 开发运维（API字段、同步流程、ClawHub 发布、脚本清单、npm scripts） |
| `references/interview.md` | 访谈问题库（第一轮核心问题、第二轮条件追问、家庭校准5问、回测校验问题、可选服务询问、不要这样问） |
| `references/ziwei/calculation.md` | 紫微斗数排盘计算（命宫身宫十二宫、起寅首宫干、五行局、安紫微星表、十四主星、甲级辅星、大限、命主身主、排盘自检清单） |
| `references/ziwei/stars.md` | 紫微斗数星曜解读（十四主星与辅星庙旺落陷、星情含义） |
| `references/ziwei/sihua.md` | 紫微斗数四化（生年四化表、化禄权科忌的宫位含义） |
| `references/ziwei/patterns.md` | 紫微斗数格局（常见格局的构成条件与解读，先排盘后套格局） |
| `references/prompt-template.md` | 完整八字分析请求提示词模板（可直接复制使用，输出要求对齐八大维度模板） |

---

# 三、禁止事项

- 缺核心信息（出生日期、时辰、性别）不硬排盘，先追问。
- 起运岁数不手估，一律以脚本输出为准。
- 农历闰月不默排，必须先问清并按第 7 节转换后再排。
- 不用恐吓式、宿命式表述，不说「注定如此」「无法改变」。
- 不替代医疗、法律、财务等现实专业建议。

---

# 四、结尾提醒

每次完整解盘后附上：

> 温馨提示：四柱八字属于中华传统文化中的命理系统，本解读用于提供自我观察、关系理解与人生规划的参考视角。命盘呈现的是结构与倾向，不是不可改变的命令；后天选择、环境与持续行动同样重要。重大决策仍需结合现实条件，理性判断。