1. 项目定位与用途
本项目是专为 Claude Code 环境设计的 Skill 插件,定位为八字排盘与命理分析工具。其核心用途是通过自然语言交互,自动完成从出生信息收集、四柱八字排盘到多维命理分析的全流程。用户无需掌握复杂的命理计算规则,即可获得基于传统典籍的命盘解读,包括日主强弱、十神关系、五行平衡、格局判定等内容,并延伸至事业、感情、健康等生活领域的建议。
本 Skill 插件用于在 Claude Code 环境中进行八字命理分析。它自动收集出生信息、排出四柱八字,并基于《三命通会》等九本经典典籍提供日主强弱、十神、五行平衡等综合分析。了解安装方式、使用方法和参考典籍。
基于 Claude Code 的八字排盘与命理分析 Skill 插件,通过交互对话自动排出四柱八字,并参照九本经典典籍进行综合解读,提供事业、感情、健康等建议。
本项目是专为 Claude Code 环境设计的 Skill 插件,定位为八字排盘与命理分析工具。其核心用途是通过自然语言交互,自动完成从出生信息收集、四柱八字排盘到多维命理分析的全流程。用户无需掌握复杂的命理计算规则,即可获得基于传统典籍的命盘解读,包括日主强弱、十神关系、五行平衡、格局判定等内容,并延伸至事业、感情、健康等生活领域的建议。
传统八字排盘依赖专业知识,涉及天干地支、节气、大运等复杂计算,且需查阅大量典籍进行解读,学习门槛高、操作繁琐。本 Skill 将这些流程自动化,通过交互式对话引导用户提供必要信息,利用 references 目录下的规则文件进行精确计算,并综合九本经典典籍的规则摘要生成分析报告,从而解决了专业门槛高、计算复杂、解读困难的问题,让命理分析变得便捷易用。
主要适用于 Claude Code 用户:一是直接进行八字命理查询,快速获取个人命盘分析;二是学习传统八字排盘规则和命理分析方法,通过插件输出理解各要素关系;三是作为传统文化学习与娱乐的辅助工具,获取基于经典典籍的参考意见。不适用于任何正式决策,仅作学习研究之用。
安装需将仓库克隆至 Claude Code 的 skills 目录。有两种方式:一是安装到当前项目,在 git 仓库根目录执行 mkdir -p .claude/skills 后克隆;二是安装到全局,克隆到 ~/.claude/skills 目录,使所有项目可用。具体命令为 git clone https://github.com/jinchenma94/bazi-skill .claude/skills/bazi 或对应全局路径。注意 Claude Code 从 .claude/skills/ 查找 skill,必须在正确位置执行。
在 Claude Code 中输入任意关键词即可触发,包括:算八字、看八字、批八字、排八字、四柱、命盘、算命、排盘、bazi。触发后,Skill 会逐步引导用户提供姓名、阳历/农历生日、出生时辰、性别、出生地等信息,完成信息收集后自动进行排盘计算,并输出四柱八字、大运流年及基于九本经典典籍的综合分析报告。整个过程为交互式对话,用户按提示回复即可。
实现上采用单技能插件架构,核心逻辑集中于 SKILL.md,分为信息收集与排盘计算两阶段。排盘计算动态读取 references 目录下的规则文件:wuxing-tables.md 提供五行、天干地支、十神等基础数据;shichen-table.md 提供时辰对照与日上起时法;dayun-rules.md 定义大运顺逆排与起运年龄计算;classical-texts.md 汇总九本经典典籍的核心论命规则。分析阶段综合这些规则,进行多维度解读。参考典籍包括《穷通宝典》《三命通会》《滴天髓》等九部,覆盖调候、格局、旺衰、神煞等各个方面。
将仓库克隆到 Claude Code 的 skills 目录:当前项目执行 mkdir -p .claude/skills 后 git clone 到 .claude/skills/bazi;或全局安装克隆到 ~/.claude/skills/bazi。具体命令见 README 安装部分。
输入任意关键词触发,包括:算八字、看八字、批八字、排八字、四柱、命盘、算命、排盘、bazi。触发后按提示逐步提供出生信息即可。
参照九本经典命理典籍:《穷通宝典》(论日主调候)、《三命通会》(论格局神煞)、《滴天髓》(论五行旺衰)、《渊海子平》(论十神六亲)、《千里命稿》(论命例实证)、《协纪辨方书》(论择日神煞)、《果老星宗》(论星命合参)、《子平真诠》(论用神格局)、《神峰通考》(论命理辨误)。
排盘计算动态读取 references 目录下的规则文件,包括 wuxing-tables.md、shichen-table.md、dayun-rules.md 等,这些文件提供了完整的五行、时辰、大运规则,确保计算准确性。
不能。本 Skill 仅供传统文化学习与娱乐参考,分析结果不构成任何决策依据。命理学属于传统文化范畴,请理性看待。