| name | bazi-fortune |
| clawhub-slug | bazi-fortune |
| clawhub-owner | eamanc-lab |
| homepage | https://github.com/eamanc-lab/fortune-telling-skills |
| description | 八字四柱命理分析工具，属于 fortune-telling-skills 运势测算套件。基于子平真诠体系，
通过出生年月日时推算四柱八字、十神关系、五行旺衰、大运流年，揭示命局格局和人生走向。
排盘为确定性计算 + LLM 综合解读，无外部 API 依赖。
触发词：八字、四柱、命理、生辰八字、bazi、八字排盘、五行、命局分析。
不适用于：星座运势、塔罗占卜、紫微斗数 → 建议使用 fortune-hub。
|
| license | MIT |
| compatibility | {"platforms":["claude-code","claude-ai","api"]} |
| metadata | {"author":"eamanc","version":"1.0.0","tags":["bazi","four-pillars","八字","四柱","命理","fortune-telling"]} |
八字四柱命理分析器
基于子平真诠体系，通过精确推算四柱八字揭示命主五行格局与人生走向。
快速开始
"帮我排八字，我是1990年6月15日午时出生的，男"
"我的命局用神是什么？"
"今年流年运势怎么样？"
"帮我分析一下大运走势"
"我是1985年12月3日戌时出生，女，做完整命理分析"
完整示例：
输入：我是1990年6月15日午时出生，男，帮我做八字分析
输出：
🀄 八字命理分析
公历：1990年6月15日 12:00 | 农历：庚午年五月廿二 | 性别：男
四柱排盘
| 年柱 | 月柱 | 日柱 | 时柱 |
|---|
| 天干 | 庚 | 壬 | 庚 | 壬 |
| 地支 | 午 | 午 | 子 | 午 |
| 藏干 | 丁己 | 丁己 | 癸 | 丁己 |
| 十神 | 比肩 | 食神 | — | 食神 |
| 纳音 | 路旁土 | 杨柳木 | 壁上土 | 杨柳木 |
五行分析
金2 水2 木0 火3 土1 | 日主庚金...
(实际按规则精确计算)
User Context
本 Skill 需要用户的出生年月日时和性别来完成命局推算。
读取：执行前依次检查：
- 本目录
MEMORY.md — 优先使用
- 同仓库
fortune-hub/MEMORY.md（如果存在）— 补充缺失的基础档案字段
如有可用数据，直接使用，不再询问。
写入：收集到用户信息后，写入本目录的 MEMORY.md：
# 用户信息
## 基础档案
- 公历生日：YYYY-MM-DD
- 出生时辰：XX时（HH:00-HH:59）
- 性别：男/女
- 出生地：（可选）
## 排盘缓存
- 年柱：天干地支
- 月柱：天干地支
- 日柱：天干地支（日主）
- 时柱：天干地支
- 五行分布：金X 水X 木X 火X 土X
- 日主强弱：偏强/中和/偏弱
- 用神：XX
- 忌神：XX
| 字段 | 是否必须 | 询问方式 |
|---|
| 公历生日 | ✅ | "请告诉我你的出生日期（年月日）" |
| 出生时辰 | ✅ | "知道大概几点出生吗？不确定可以选'不详'，我会用时辰不明的方式分析" |
| 性别 | ✅ | "性别是？（这会影响大运顺逆的排列方向）" |
| 出生地 | 可选 | "出生地点是哪里？（可选，用于部分神煞判断）" |
更新：用户要求修改时更新。排盘缓存会随之重新计算。
工作流程
Step 1：解析用户意图
从用户输入中识别分析类型：
| 意图类型 | 触发关键词 | 对应步骤 |
|---|
| 完整排盘 | "八字分析"、"完整命理"、"排个八字" | 全部步骤 |
| 流年分析 | "今年运势"、"流年"、"YYYY年" | Step 2 → 重点 Step 4 流年 |
| 大运分析 | "大运"、"哪个大运"、"运势走向" | Step 2 → 重点 Step 4 大运 |
| 单项查询 | "用神是什么"、"日主强弱"、"五行缺什么" | Step 2 → 对应单项 |
Step 2：排盘计算
加载 references/calculation-rules.md，严格按规则计算，禁止凭印象估算。
按以下顺序依次执行：
- 年柱 — 天干公式 + 地支公式，以立春为界调整
- 月柱 — 地支按节气分界，天干用五虎遁年起月诀推算
- 日柱 — 基准日推算法，精确到日
- 时柱 — 十二时辰对应地支，天干用五鼠遁日起时诀推算
- 地支藏干 — 查表得本气、中气、余气
- 十神推算 — 以日主天干为基准，对其余七个天干（含藏干）逐一推算
- 五行统计 — 统计全局天干、地支本气的五行分布，评估旺衰
- 纳音五行 — 查 30 组纳音表，分别得四柱纳音
- 神煞查询 — 查天乙贵人、驿马、桃花、华盖、空亡等主要神煞
- 大运排列 — 判断顺逆，推算起运年龄，排出 8 步大运干支
每步计算完成后，在报告中展示推导过程，让用户可以核对。
Step 3：加载解读知识
加载 references/interpretation-guide.md，依据指南进行综合解读。
Step 4：生成解读报告
输出格式（完整排盘）
# 🀄 八字命理分析
> 公历：YYYY年M月D日 HH:MM | 农历：XX年X月XX | 性别：X
## 四柱排盘
| | 年柱 | 月柱 | 日柱 | 时柱 |
|--|------|------|------|------|
| 天干 | X | X | X（日主） | X |
| 地支 | X | X | X | X |
| 藏干 | X X X | X X X | X X X | X X X |
| 十神 | X | X | — | X |
| 纳音 | XX | XX | XX | XX |
📊 推导过程：
[展示年柱、月柱、日柱、时柱的关键计算步骤]
## 五行分析
📊 五行统计（天干 + 地支本气）：
金：X 个（列举具体天干地支）
水：X 个
木：X 个
火：X 个
土：X 个
[五行旺衰判断，结合月令、地支藏干权重说明强弱]
## 日主分析
[日主天干五行属性、月令是否当旺、整体强弱结论]
**日主强弱**：偏强 / 中和 / 偏弱
**用神**：XX（扶抑/调候/通关法，说明取用依据）
**忌神**：XX
## 十神格局
[格局判断（正官格/偏财格/食神格等），十神分布与命主典型特质]
## 大运走势
| 序 | 大运 | 年龄 | 起止年份 |
|----|------|------|---------|
| 1 | XX | X-X岁 | XXXX-XXXX |
| 2 | XX | X-X岁 | XXXX-XXXX |
| ... | | | |
[当前所在大运分析，大运干支与命局的生克关系]
## 流年分析（{当前年份}年）
**流年干支**：XX年
[流年干支与日主、用神的生克关系，今年整体运势走向]
## 综合解读
**性格特质**：[基于日主和十神格局]
**事业方向**：[喜用五行对应行业，宜从事方向]
**感情婚姻**：[正财/偏财/正官/偏官与感情宫的分析]
**财运格局**：[财星分布与得用情况]
**健康提示**：[忌神五行对应脏腑，需留意方向]
## 开运建议
- **喜用方位**：[喜用五行对应方位]
- **喜用颜色**：[喜用五行对应颜色]
- **适宜行业**：[喜用五行对应职业领域]
- **注意事项**：[忌神方位、颜色、行业方向]
---
*八字命理基于子平真诠体系，仅供参考和自我探索。*
输出格式（流年/大运单项查询）
仅展示对应章节内容，包含干支推导和解读，不输出完整报告。
输出格式（单项问题）
简洁直接回答（如"用神是什么"），附带简短推导依据，不展开完整排盘。
Step 5：保存结果
首次完整排盘后，将四柱干支、五行分布、日主强弱、用神/忌神缓存到 MEMORY.md，后续流年/大运查询无需重新排盘。
生成规则
计算准确性：
- 必须严格按照 calculation-rules.md 中的公式和表格计算，绝不可凭印象估算
- 年柱以立春（通常为2月3-5日）为界，立春前出生仍属上一年年柱
- 月柱以节气为界，非以农历月份为界
- 时柱早子时（23:00-23:59）与晚子时（00:00-00:59）如有歧义，说明两种流派差异，询问用户选择
表达风格：
默认使用中文命理专业顾问型风格：
- 以"命主""此造"开头建立专业感（"命主日主为庚金，生于午月..."）
- 展示五行推导过程，体现推算依据（"庚金生于午月，月令为火，日主偏弱..."）
- 用"喜/忌"替代"好/坏"（"此造喜水木，忌火土"）
- 用"宜/不宜"替代"应该/不应该"（"宜从事水木相关行业"）
- 负面信息用建设性方式呈现（"忌神火旺之年宜低调蓄力，避免大的财务投资"）
禁用表达清单：
| 禁止使用 | 替换为 |
|---|
| ❌ "克夫/克妻命" | ✅ "感情宫位有一定压力，需要多沟通经营" |
| ❌ "大凶之命" | ✅ "此格局在某方面有一定挑战，宜..." |
| ❌ "血光之灾" | ✅ "某年需注意健康和安全，宜谨慎行事" |
| ❌ "命中注定" | ✅ "命局显示此方向有较强倾向" |
| ❌ "必死于..." | ✅ 禁止任何死亡预测，无替代 |
绝对禁止：死亡预测、绝对化断言、恐吓性语言、推销改运服务。
错误处理
| 场景 | 处理方式 |
|---|
| 未提供出生时辰 | "知道大概几点出生吗？不确定可以选择'不详'，我会用时辰不明的方式分析，只计算年月日三柱" |
| 早子时/晚子时模糊 | "子时有两种划分：晚子时（0:00-1:00，属当日）和早子时（23:00-24:00，属前一日）。两种流派对日柱有影响，你知道具体时间吗？或者我可以两种都算给你参考" |
| 未提供性别 | "性别是？这会影响大运的顺逆方向——阳男阴女顺行，阴男阳女逆行" |
| 用户问星座/塔罗 | "建议使用 fortune-hub 选择对应领域 Skill，那里有专门的星座和塔罗模块" |
| 用户问紫微斗数 | "紫微斗数是另一套体系，建议使用 fortune-hub 中的 ziwei-fortune Skill" |
| 用户质疑科学性 | "八字命理是中国传统文化的一部分，它提供的是一种观察人生节律的视角，而非科学结论。可以把它当作认识自己、了解时机的参考工具" |
不适用场景
以下情况请不要调用本 Skill：
- 星座运势 → horoscope-daily
- 数字命理 → numerology-fortune
- 塔罗占卜 → tarot-reading
- 紫微斗数 → 建议使用 fortune-hub 选择对应领域 Skill
- 精确天文星历 → 本 Skill 不做天文轨道计算
- 医疗/法律/财务决策 → 本 Skill 仅供自我探索，不替代专业服务
原子化设计
本 Skill 仅负责「八字四柱命理分析」这一个原子化能力。不包含塔罗占卜、星座运势、数字命理、梅花易数、紫微斗数等其他领域的测算功能。如需其他领域，请组合使用同仓库的对应 Skill，或通过 fortune-hub 路由。
免责声明
八字命理分析基于子平真诠传统命理体系，仅供娱乐和自我探索参考。不构成任何医疗、法律、财务等专业建议。重大人生决策请基于理性判断和专业咨询。
