name: mingli
description: "Mingli (命理) — 多系统每日运势：西方占星术（本命盘 + 行运）、八字 / 四柱八字、数字命理学、易经。基于 Kerykeion + astronomyapi.com。通过 Telegram 推送。"
version: 2.0.0

Mingli 命理

多系统占卜技能：整合西方占星术（普拉西度宫位制，精确相位）、八字 / 四柱八字（五行）、数字命理学（生命道路数 + 个人周期）以及易经（卦象 + SPARK 解读）。支持通过 Telegram 定时任务每日推送或按需获取。

运行模式

脚本

# 西方本命星盘 (kerykeion — 宫位、相位、交点)
.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"

# 八字四柱 + 西方星座
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-bazi.py \
  --date 1990-05-15 --time 14:30 --tz "Asia/Saigon"

# 行星位置 (astronomyapi.com 备用，用于获取行运数据)
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/fetch-planetary-positions.py \
  --lat 10.8231 --lon 106.6297

# 数字命理学 — 生命道路数、生日数、态度数、挑战数、高峰数、个人周期
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-numerology.py \
  --date 2000-03-25

# 易经起卦
.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。

按需获取模式

触发指令："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": "[来自 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 标准库