zhizhi-bazi-skill 是一个面向智能体的四柱八字技能。它把「排盘计算」「多本命理经典互证」「千里命稿式断事校准」「不确定性说明」拆成清晰的工作流，让智能体先算清命盘事实，再进行谨慎、可校准、不过度宿命化的分析。
如果这个项目对你的八字研究、命理学习或智能体技能开发有帮助，欢迎点一个星标，让更多人能搜到它。
很多八字智能体提示词容易出现两个问题：
- 靠记忆或模型心算排盘，年柱、月柱、日柱、时柱、大运容易错。
- 机械套用某一本书，尤其是直接把《千里命稿》的断语搬到现代语境里，缺少调候、旺衰、格局、大运流年和历史反馈校准。
这个技能采用的流程是：
出生信息 -> 排盘事实 -> 调候/旺衰/格局 -> 大运流年引动 -> 历史事件校准 -> 实用建议
目标不是制造神秘感，而是让智能体像一个有方法的命理研究助手：先确认事实，再说明依据，再承认不确定性。
- 四柱排盘：根据阳历出生日期和时间计算年柱、月柱、日柱、时柱。
- 十神与藏干：输出天干十神、地支藏干和藏干十神。
- 大运辅助：计算传统顺逆排方向和约略起运年龄。
- 夜子时提示：对 23:00 至 23:59 出生采用「夜子时按次日日柱」的约定，并明确提示。
- 节气边界提示：出生日期靠近节气时，提示需要用可靠万年历或历算工具复核。
- 多书互证：每本经典都有明确职责，避免把书名当装饰或权威堆砌。
- 历史校准：在给出强判断前，先提出可验证的过往事件假设，让用户反馈修正。
- 安全表达：避免恐吓式、绝对式、医疗/投资/婚育保证式断语。
- 多智能体协作友好：提供交接文档和任务分工，方便多个智能体继续维护。
克隆仓库：
git clone <仓库地址>
cd zhizhi-bazi-skill
运行排盘：
python scripts/calc_bazi.py --date 1990-05-15 --time 08:30 --sex 男
示例输出：
排盘结果
- 出生信息：1990-05-15，08:30，男
- 当前节令：立夏（1990-05-06）
- 四柱：庚午 / 辛巳 / 庚寅 / 庚辰
- 日主：庚（金，阳）
- 大运方向：顺排
- 约略起运：7 年 4 个月，参考边界为芒种（1990-06-06）
输出结构化结果：
python scripts/calc_bazi.py --date 1990-05-15 --time 08:30 --sex 男 --json
运行自测：
python scripts/calc_bazi.py --self-test
在智能体里调用：
使用 $zhizhi-bazi-skill 帮我分析一个八字命盘。
更多提示词示例见 examples/sample-prompts.md。
这个技能不把所有古籍混成一锅，也不让某一本书独占解释权。每本书都有明确用途：
| 经典 | 在本技能中的职责 |
|---|---|
| 《渊海子平》 | 十神、六亲、基础格局术语的根基。 |
| 《子平真诠》 | 格局清浊、用神、相神、成格败格。 |
| 《滴天髓》《滴天髓阐微》 | 旺衰、气势、流通、阻滞、通关，防止死套格局。 |
| 《穷通宝鉴》《造化元钥》 | 调候用神，判断寒暖燥湿与季节需求。 |
| 《三命通会》 | 特殊格局、神煞、古诀、例外规则的大型资料库。 |
| 《千里命稿》 | 实际断事、宫位、案例类比、历史事件校准。 |
| 《神峰通考》 | 辟谬、病药说、反机械套用神煞。 |
| 《命理约言》 | 保守辨析，压制夸张断语。 |
| 《五行精纪》 | 古法禄命、五行与神煞资料的辅助背景。 |
| 《星平会海》《果老星宗》 | 星命扩展，只在用户明确需要混合体系时使用。 |
| 《兰台妙选》 | 纳音与特殊格局旁证，不替代核心四柱判断。 |
| 《协纪辨方书》 | 神煞、择日和历法概念的可选参考。 |
冲突判断优先级：
节气与排盘事实
> 调候与季节需求
> 日主旺衰与气势流通
> 格局成败与用神完整性
> 大运流年引动
> 十神与宫位象义
> 神煞、特殊口诀、单条断语
zhizhi-bazi-skill/
SKILL.md
README.md
AGENTS.md
LICENSE
agents/
openai.yaml
examples/
sample-prompts.md
references/
analysis-protocol.md
classical-lenses.md
qianli-method.md
tables.md
edge-cases.md
safety-tone.md
agent-handoff.md
scripts/
calc_bazi.py
- SKILL.md：定义触发条件、信息收集、参考文件路由、排盘流程、分析流程、输出规则和边界处理。
- agents/openai.yaml：智能体界面元数据。
- analysis-protocol.md：从排盘事实到历史校准和最终建议的完整推理顺序。
- classical-lenses.md：说明各本经典的职责，以及规则冲突时如何裁决。
- qianli-method.md：说明如何使用《千里命稿》做宫位、断事、案例类比和反馈修正。
- tables.md：天干、地支、藏干、十神、五行生克、天干合化、地支关系。
- edge-cases.md：夜子时、节气边界、只知道农历、时辰未知、真太阳时、儿童、已故之人、健康、婚育、金钱等边界情况。
- safety-tone.md：避免宿命化、恐吓式和越界建议的表达规则。
- agent-handoff.md：给其他智能体继续维护或审查时使用的方案文档。
- calc_bazi.py：根据 1900 至 2100 年的阳历日期计算排盘事实。
- 输出年柱、月柱、日柱、时柱、日主、藏干、十神、大运方向、约略起运年龄和风险提示。
- 脚本只负责事实计算，不负责命理解读。
已知限制：
- 节气使用简化近似算法；如果出生日期在节气前后一天内，应使用可靠万年历或历算工具复核。
- 暂不做农历转阳历。
- 暂不做真太阳时精确校正，只在临近时辰边界时提示风险。
- 想构建八字命理智能体的人。
- 想学习如何把传统命理资料整理成智能体技能的人。
- 想要一个小型、可读、可审查的八字排盘辅助脚本的人。
- 想减少机械套书、提高命理分析一致性的人。
四柱八字、八字排盘、八字命理、八字分析、命盘、命理、子平、十神、用神、大运、流年、千里命稿、滴天髓、子平真诠、穷通宝鉴、三命通会、神峰通考、五行、天干地支、智能体技能、命理智能体、传统文化。
在仓库根目录运行：
python scripts/calc_bazi.py --self-test
python scripts/calc_bazi.py --date 1990-05-15 --time 08:30 --sex 男 --json
python <skill-creator路径>/scripts/quick_validate.py .
预期结果：
- 自测通过。
- 示例结构化结果包含四柱、日主、大运方向、大运列表和必要提示。
- 技能校验通过。
欢迎补充：
- 更精确的节气历算支持。
- 可靠的农历转阳历能力和测试样例。
- 来自可信万年历的排盘测试用例。
- 更好的中文提示词和评测样例。
- 更多经典资料的「可执行规则」摘要。
多人或多智能体协作时，请先读 AGENTS.md，再读 references/agent-handoff.md。
本项目在设计阶段参考了 jinchenma94/bazi-skill 对 SKILL.md 与 references/ 分层组织的思路，尤其是将交互流程、排盘规则和经典资料拆开的做法。感谢原作者开放这个八字技能项目。
本项目用于传统文化学习、命理研究和自我观察，不构成科学预测，也不提供医疗、法律、财务、心理、婚育或投资建议。
本项目采用 MIT 许可证，见 LICENSE。