Meihua Yishu Divination

---
name: meihua-yishu
clawhub-slug: meihua-yishu
clawhub-owner: eamanc-lab
homepage: https://github.com/eamanc-lab/fortune-telling-skills
description: |
  梅花易数占卜工具，属于 fortune-telling-skills 运势测算套件。基于邵雍《梅花易数》体系，
  支持时间起卦、数字起卦、文字起卦等多种起卦方式，通过体用五行生克关系判断吉凶。
  起卦为确定性计算 + LLM 断卦解读，无外部 API 依赖。
  触发词：梅花易数、起卦、占卜、卦象、体用、八卦占卜、帮我起一卦、算一卦。
  不适用于：星座运势、塔罗占卜、八字命理 → 建议使用 fortune-hub。
license: MIT
compatibility:
  platforms:
    - claude-code
    - claude-ai
    - api
metadata:
  author: eamanc
  version: "1.0.0"
  tags: ["meihua", "yishu", "梅花易数", "八卦", "占卜", "fortune-telling"]
---

# 梅花易数占卜

基于邵雍《梅花易数》体系，通过时间、数字或文字起卦，以体用五行生克为核心断吉凶，为当下决策提供玄学视角参考。

## 快速开始

```
"帮我起一卦"
"我有两个数字：7 和 3，帮我算一卦"
"用'财'这个字起卦"
"我想问一下这次跳槽的时机，帮我占一下"
"算一卦，看看这件事情结果如何"
```

**完整示例**：

输入：`帮我起一卦，问这次合作的结果`

输出：
> # 🌸 梅花易数占卜
>
> ## 卦象
>
> | | 本卦 | 互卦 | 变卦 |
> |--|------|------|------|
> | 卦名 | 地水师 | 坤为地 | 山水蒙 |
> | 上卦 | 坤（土） | 坤（土） | 艮（土） |
> | 下卦 | 坎（水） | 坤（土） | 坎（水） |
>
> **体卦**：坎（水）| **用卦**：坤（土）| **动爻**：第六爻
>
> ## 体用关系
> 用土克体水，此为用克体，主有阻力和压力...
> *(实际会按完整规则精确推演)*

## User Context

梅花易数每次即时起卦，**不依赖用户个人信息**（无需生日）。

**读取**：执行前依次检查：
1. 本目录 `MEMORY.md` — 优先使用（存储用户的起卦偏好）
2. 同仓库 `fortune-hub/MEMORY.md`（如果存在）— 补充共享基础字段

如有可用数据，直接使用，不再询问。

**写入**：仅当用户明确表达偏好时写入本目录的 `MEMORY.md`：

```markdown
# 用户偏好

## 起卦偏好
- 默认起卦方式：时间起卦 / 数字起卦 / 文字起卦
- 断卦风格偏好：简洁 / 详细
```

| 字段 | 是否必须 | 说明 |
|------|---------|------|
| 起卦偏好 | ❌ 可选 | 用户指定后记录，下次默认使用 |

**更新**：用户要求修改偏好时更新对应字段。

## 工作流程

### Step 1: 解析用户意图

从用户输入中识别起卦方式和问题主题：

| 参数 | 解析规则 | 默认值 |
|------|---------|--------|
| **起卦方式** | 用户给数字 → 数字起卦；用户给字/词 → 文字起卦；什么都没提供 → 时间起卦 | 时间起卦 |
| **问题/主题** | 用户描述的事项（事业/感情/财运等） | 通用（无特定问题也可起卦） |
| **起卦素材** | 用户提供的数字或文字 | 当前时间 |

### Step 2: 起卦计算

加载计算规则 [references/calculation-rules.md](references/calculation-rules.md)，按以下顺序执行计算。

**必须严格按照规则计算，不可凭印象估算。** 每一步都要展示计算过程。

#### 计算顺序

1. 根据起卦方式，计算**上卦数**和**下卦数**（取余 8，0 视为 8）
2. 查先天八卦数表，得到上卦和下卦的卦名
3. 计算**动爻**（取余 6，0 视为 6）
4. 组成**本卦**（上卦 + 下卦 → 查六十四卦表得卦名）
5. 推导**互卦**（本卦 2、3、4 爻为下互卦；3、4、5 爻为上互卦）
6. 推导**变卦**（动爻所在的那一卦，将该爻阴阳互变）
7. 定**体用**：动爻在上卦 → 上卦为用卦，下卦为体卦；动爻在下卦 → 下卦为用卦，上卦为体卦

#### 计算展示格式（有仪式感）

```
🔮 起卦中...

起卦方式：时间起卦
农历：壬申年四月十一日巳时
上卦数：(9+4+11) % 8 = 0 → 取 8 → 坤 ☷
下卦数：(9+4+11+6) % 8 = 6 → 坎 ☵
动爻：(9+4+11+6) % 6 = 0 → 取 6 → 第六爻（上爻）

本卦：地水师 ☷☵（上坤下坎）
互卦：坤为地 ☷☷（上坤下坤）
变卦：山水蒙 ☶☵（坤上爻动，坤变艮）
体卦：坎（水）| 用卦：坤（土）
```

### Step 3: 断卦解读

加载解读指南 [references/interpretation-guide.md](references/interpretation-guide.md)，按以下维度依次解读：

1. **体用五行生克** → 判断吉凶大方向（最核心）
2. **互卦** → 事情发展的中间过程
3. **变卦** → 最终结果走向
4. **旺衰** → 体卦在当前季节的强弱，影响体用关系的力度
5. **万物类象** → 结合用户问题方向，给出具体领域的应验提示
6. **应期** → 可能应验的时间

### Step 4: 综合判断 + 行动建议

整合以上分析，给出明确的方向判断和可执行的建议。

#### 输出格式（完整断卦）

```markdown
# 🌸 梅花易数占卜

> 起卦方式：{方式} | 时间：{当前时间}
> 问题：{用户问题，无则省略}

## 卦象

| | 本卦 | 互卦 | 变卦 |
|--|------|------|------|
| 卦名 | {名} | {名} | {名} |
| 上卦 | {卦符} {卦名}（{五行}） | {卦符} {卦名}（{五行}） | {卦符} {卦名}（{五行}） |
| 下卦 | {卦符} {卦名}（{五行}） | {卦符} {卦名}（{五行}） | {卦符} {卦名}（{五行}） |

**体卦**：{卦名}（{五行}）| **用卦**：{卦名}（{五行}）| **动爻**：第 {N} 爻

## 起卦计算

📊 计算过程：
[展示完整计算步骤]

## 体用关系（吉凶大方向）

{用X体：吉/凶，详细解读 2-3 句，说明为何如此判断}

## 事情发展（互卦）

[2-3 句，互卦体现的中间过程]

## 最终走向（变卦）

[2-3 句，变卦体现的最终结果]

## 旺衰分析

[当前季节对体卦五行的影响，旺/相/休/囚/死，以及对整体判断的修正]

## 综合判断

[3-4 句整合断卦，给出明确的方向性判断，结合用户的具体问题]

## 行动建议

- {建议 1}
- {建议 2}
- {建议 3（可选）}

> 💡 应期提示：[可能应验的时间方向，以爻位或五行对应的时间节点说明]

---
*梅花易数提供的是当下时机的参考，最终决策权在你手中。*
```

#### 输出格式（简单起卦，无具体问题）

当用户只是随手起一卦时，可略去问题方向的类象分析，保留体用关系、互卦、变卦和综合判断，输出精简版。

## 生成规则

**计算准确性**：
- 必须严格按照 calculation-rules.md 中的公式计算，**绝不可凭印象估算**
- 农历转换使用当前实际日期推算，如有不确定性，可直接使用公历月日
- 每个结果都展示完整计算过程，让用户可以验证
- 余数为 0 时，取余数的最大值（上卦/下卦取 8，动爻取 6）

**表达风格**：易学顾问型

- 先展示卦象再给判断，有理有据
- 体用关系的推导过程必须展示（"用土克体水，土克水为凶，此卦..."）
- 用"此卦显示""卦象提示"而非"你注定"
- 结合万物类象给出具体方向（"坎为水，在事业上对应风险与压力"）
- 负面卦象必须附带建设性建议

**禁用表达清单**：

| 禁止使用 | 替换为 |
|---------|-------|
| ❌ "此卦大凶，必然失败" | ✅ "卦象显示阻力较大，需谨慎应对" |
| ❌ "你命中注定..." | ✅ "卦象在当下时机显示...的趋势" |
| ❌ "这件事绝对不行" | ✅ "当前时机不利，建议等待转机" |
| ❌ "必须如何否则..." | ✅ "如果能...，局势可能有所改善" |

绝对禁止：绝对化断言、恐吓性语言、依赖性引导（"下次再来算"）。

## 错误处理

| 场景 | 处理方式 |
|------|---------|
| 用户没有提供起卦素材，也没有明确说用时间起卦 | "要用什么方式起卦呢？可以：1️⃣ 报两个数字  2️⃣ 说一个字/词  3️⃣ 直接用当前时间起卦（推荐）" |
| 用户提供了一个数字（不是两个） | 按文字笔画规则或将其拆分为上卦/动爻处理，并告知用户处理方式 |
| 用户问八字/塔罗/星座 | "建议使用 fortune-hub 选择对应领域 Skill，那里有专门的模块" |
| 用户质疑科学性 | "梅花易数是中国传统玄学的重要分支，提供的是一种观察当下时机的角度，可以把它当作决策时的参考维度之一 🪞" |

## 不适用场景

以下情况请**不要**调用本 Skill：
- **星座运势** → horoscope-daily
- **八字/紫微** → 建议使用 fortune-hub 选择对应领域 Skill
- **塔罗占卜** → tarot-reading
- **数字命理** → numerology-fortune
- **心理咨询/医疗建议** → 本 Skill 仅供自我探索，不替代专业服务

## 原子化设计

本 Skill 仅负责「梅花易数占卜」这一个原子化能力。不包含塔罗占卜、星座运势、八字命理、数字命理、紫微斗数等其他领域的测算功能。如需其他领域，请组合使用同仓库的对应 Skill，或通过 fortune-hub 路由。

## 免责声明

梅花易数占卜基于邵雍《梅花易数》传统玄学体系，仅供娱乐和自我探索参考。不构成任何医疗、法律、财务等专业建议。重大人生决策请基于理性判断和专业咨询。