bazi-skill-gaoxin492-main

bazi-skill

八字命理分析 Agent Skill。通过调用本地 Python 脚本完成排盘计算与命盘存储，由你负责解读。

默认安装目录固定为：~/.claude/skills/bazi-skill

脚本清单

脚本	用途
calculate_bazi.py	排盘计算，输出完整命盘 JSON
store_bazi.py	命盘本地存储（保存 / 读取 / 列出 / 删除）

---

初始化（首次使用时执行）

不要假设当前工作目录就是 skill 目录。统一使用下面两个变量：

SKILL_DIR="$HOME/.claude/skills/bazi-skill"
if [ -x "$SKILL_DIR/.venv/bin/python" ]; then
	PYTHON="$SKILL_DIR/.venv/bin/python"
else
	PYTHON=python3
fi

后续所有命令都基于 $SKILL_DIR 和 $PYTHON 执行，不要直接写相对路径 calculate_bazi.py，否则可能在 ~/.claude 或其他目录下报找不到文件。

推荐初始化方式：

SKILL_DIR="$HOME/.claude/skills/bazi-skill"
if [ -x "$SKILL_DIR/.venv/bin/python" ]; then
	PYTHON="$SKILL_DIR/.venv/bin/python"
else
	PYTHON=python3
fi

$PYTHON -c "import lunar_python, timezonefinder, geopy, pytz" 2>/dev/null || \
$PYTHON -m pip install -r "$SKILL_DIR/requirements.txt" -q

如果本地安装依赖时遇到 AttributeError: _ARRAY_API not found，通常是 NumPy 2.x 与某些二进制依赖不兼容。使用仓库内的 requirements.txt 重新安装即可；其中已固定 numpy<2 来规避这个问题。

如果仓库里没有 requirements.txt，则安装以下依赖：

$PYTHON -m pip install 'numpy<2' lunar-python timezonefinder geopy pytz -q

依赖安装成功后正常调用脚本。无需每次检查，只在首次或环境异常时执行。

---

调用规范

calculate_bazi.py

$PYTHON "$SKILL_DIR/calculate_bazi.py" --pretty '<JSON参数>'

调用规则分两层：

• 后台推演、保存命盘时：使用 --json 获取结构化数据，供分析与存储使用
• 面向用户展示命盘时：必须再调用一次 --pretty，展示终端彩色排盘结果

后台推演示例：

$PYTHON "$SKILL_DIR/calculate_bazi.py" --json '<JSON参数>'

终端排盘统一使用 --pretty，不再保留普通直出形式：

$PYTHON "$SKILL_DIR/calculate_bazi.py" --pretty '<JSON参数>'

如果环境支持 ANSI 颜色，--pretty 会自动上色；如果像 Claude Code CLI 这类环境不保留 TTY 颜色，脚本会自动退回纯文本显示。

也可手动指定颜色策略：

$PYTHON "$SKILL_DIR/calculate_bazi.py" --pretty --color auto '<JSON参数>'
$PYTHON "$SKILL_DIR/calculate_bazi.py" --pretty --color always '<JSON参数>'
$PYTHON "$SKILL_DIR/calculate_bazi.py" --pretty --color never '<JSON参数>'

强制展示规则：

• 新排出命盘后，如果要向用户展示四柱、十神、大运等版式，必须调用 --pretty
• 不要自己手写 Markdown 表格或重新拼一个伪命盘表来替代 --pretty 输出
• 如果 --pretty 调用失败，应先说明报错并优先修复环境或依赖，再继续解读；不要跳过展示步骤直接脑补排盘结果
• 解读内容基于 --json 的结构化数据完成；展示内容基于 --pretty 的终端输出完成