命理

多系统占卜技能：西方占星术（普拉西度宫位制，精确相位）、八字/四柱（五行）、数字命理学（生命灵数 + 个人周期）以及易经（卦象 + 火花）。每日通过 Telegram 定时任务发送或按需提供。

模式

脚本

# Western natal chart (kerykeion — houses, aspects, nodes)
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-western-natal-chart-using-kerykeion.py \
  --date 2000-03-25 --time 12:00 --tz "Asia/Saigon" --lat 21.0245 --lon 105.84117 --name "User"

# Ba-Zi Four Pillars + Western zodiac
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-bazi.py \
  --date 1990-05-15 --time 14:30 --tz "Asia/Saigon"

# Planetary positions (astronomyapi.com fallback for transit data)
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/fetch-planetary-positions.py \
  --lat 10.8231 --lon 106.6297

# Numerology — LifePath, Birthday, Attitude, Challenges, Pinnacles, Personal cycles
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-numerology.py \
  --date 2000-03-25

# I Ching hexagram casting
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py --mode random
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py \
  --mode manual --upper Kan --lower Kun --moving 2,1

设置模式

1. 询问：出生日期（YYYY-MM-DD），出生时间（HH:MM），出生城市（经纬度 + 时区）
2. 询问：Telegram 聊天 ID，首选发送时间+时区
3. 运行所有计算脚本：本命星盘、八字、数字命理
4. 将结果写入~/clawd/memory/horoscope-users.md（包含经纬度、生命灵数）
5. 创建每日定时任务
6. 确认：西方星座 + 上升星座 + 八字日主 + 生命灵数 + 发送计划

日常模式

定时任务触发 4 个脚本 → 所有 JSON 数据输入 LLM → 撰写多系统占星报告 → 发送至 Telegram。

参见references/horoscope-prompt-template.md用于完整的agentTurn消息。

按需模式

触发词："my horoscope"、"horoscope now"、"what's my horoscope today"

相同流程，内联（非独立会话）。包含每日易经卦象。

易经模式

触发词："cast I Ching"、"throw hexagram"、"que Kinh Dich"

• 随机起卦：三枚钱币法，加密随机性
• 手动输入：用户提供上卦/下卦 + 动爻
• 输出：本卦、动爻、变卦、SPARK摘要

管理命令

定时任务交付

每个用户一个定时任务：horoscope-daily-{用户名}

{
  "name": "horoscope-daily-{username}",
  "enabled": true,
  "schedule": { "kind": "cron", "expr": "0 {hour} * * *", "tz": "{timezone}" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "[prompt from references/horoscope-prompt-template.md]",
    "model": "claude-sonnet-4-20250514",
    "timeoutSeconds": 180,
    "deliver": true,
    "channel": "telegram",
    "to": "{telegram_chat_id}"
  },
  "isolation": { "postToMainPrefix": "Horoscope delivered", "postToMainMode": "summary" }
}

状态跟踪

文件：state/users.json— 将用户名映射到定时任务ID。

错误处理

• kerykeion 失败：回退到fetch-planetary-positions.py（基于API，无宫位信息）
• API 宕机：LLM仅根据星座知识生成运势
• 内存缺失：提示用户先运行设置
• 《易经》数据缺失：仅使用内置的卦象数学生成卦象

参考资料

• references/astronomyapi-reference.md- API 认证 + 端点
• references/zodiac-reference.md- 西方与中国的生肖对照表、天干、地支
• references/horoscope-prompt-template.md- 用于每日生成的LLM提示词模板
• references/i-ching-64-hexagrams.json- 包含中/越文名称的64卦

依赖项

• kerykeion(pip) — 星盘、宫位、相位。安装方法：pip install kerykeion
• astronomyapi.com— 环境变量：ASTRONOMY_APP_ID,ASTRONOMY_APP_SECRET
• 所有其他脚本：仅需Python标准库