bazi-skill

把八字排盘、命盘存档与对话式解读，打包成一个真正能落地的 Agent Skill。

不是“会说八字”的提示词壳子，而是一条可执行、可复用、可存档的完整链路。 适用环境：Claude Code、OpenClaw、DeerFlow，以及其他支持读取 SKILL.md 并执行本地命令的 Agent 框架。

“让 Agent 不只是看起来懂命理，而是真的先算，再讲。”

---

1. 核心理念与架构 (Philosophy & Architecture)

“命理不仅是计算，更是心理疗愈。” 很多强大的AI Agent只是包装了语气，但在后台却严重依赖大模型手算四柱，频发致命的干支排错问题，或者需要手动贴入排盘软件的排盘结果，每次使用都很麻烦；且一旦对话结束便没有任何上下文，无法针对某人的命盘持续追问或建立档案。

bazi-skill 围绕推演解耦与人生哲学展开：

• 计算层 (Python)：承担所有复杂的历法转换、出生地真太阳时校正、五行生克和干支排盘。模型不手算四柱，从根本上消灭排盘幻觉。
• 结构层 (JSON)：底层脚本输出纯结构化数据给大模型作为隐式上下文，确保流转数据严谨稳定。
• 解读层 (Agent)：通过 SKILL.md 强制约束 Agent 遵循“命定其势，人定其局”的价值观：好运是顺风，不努力只会庸碌度过；差运是冬蛰，向内求索即可平复。提供一套真正的“破局思维”，实现趋吉避凶。

2. 核心功能与全景展示 (Features & Showcase)

bazi-skill 并非只提供几个提示词，而是完整包裹了：交互收集 -> 终端排盘 -> 多轮解读 -> 本地存档 的端到端体验。

1️⃣ 对话式的自然参数收集

支持日常使用的**公历（带真太阳时自动校正）或农历（含闰月计算）**输入。无论语境如何，Agent 都会自然引导你集齐完整的命理要素。

2️⃣ 终端直出排盘

将原本枯燥、极容易陷入大模型幻觉的排盘交给底层 Python 处理，不仅保证算得对，更在你的终端展现色彩分明、格局清晰的排版：

3️⃣ 详细的多轮解读

基于预设的心理疗愈基线，Agent 会温和地剖析原局、推演运势的上下限，并在需要时调用本地存储管理为你创建“私人档案馆”。

3. 极简使用指引 (Installation & Workflow)

你完全不需要手动配置虚拟环境或安装依赖！ 只需将代码克隆到 Agent 支持的技能目录（推荐默认存放路径）：

git clone https://github.com/yourname/bazi-skill.git ~/.claude/skills/bazi-skill

开始使用： 直接在对话框中输入 /bazi-skill（或向 Agent 提及想要算八字）。

Agent 读取 SKILL.md 后会自动接管整个工作流：

1. 环境探测与自修复：模型会自动检查 Python 环境，并在缺少依赖时利用 requirements.txt 自动完成对应模块的安装和兼容性修复。
2. 交互收集：以自然对话形式引导你补充精准的出生时分与出生地。
3. 结构化运算与存档：精准调用计算脚本生成 JSON 供大模型深度分析，并在适当的时候自动把命理对象归档留存（基于本地 ~/.bazi_skill/profiles）。
4. 可视化输出：将经过颜色高亮与合理排版的命理面板，直接原样呈现在你的终端里。

在这里不仅脚本负责了数学层面的“算”与“存”，Agent 也接管了工程层面的“装”与“问”，体验做到了完全的零门槛开箱即用。

适合谁用？ 希望为本地或专属的 AI 提供真正可靠的八字计算能力，而不是仅依赖玄学 prompt 的开发者。无论是对首次命盘全景分析，还是对个人经历的长期阶段性复盘，bazi-skill 旨在为你打造一套个人私有的命运档案馆。

---