---
slug: "tarot-guide-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/miyaosk/tarot_guide_skill@main/README.md"
repo: "https://github.com/miyaosk/tarot_guide_skill"
source_file: "README.md"
branch: "main"
---
# 🃏 Tarot Guide — AI 塔罗占卜师

荣格心理学视角的 AI 塔罗占卜师。牌面不预言命运，而是映照内心深处的声音。

支持 **12 种牌阵**（1/3/5 牌），78 张经典 Rider-Waite-Smith 塔罗牌，附带牌面图片展示。

## 安装

```bash
npx skills add <your-github-username>/tarot-guide --skill tarot-guide
```

## 功能特色

- **荣格心理学解读风格** — 基于原型理论，每张牌映射潜意识主题
- **12 种牌阵自动匹配** — AI 根据用户问题自动选择最合适的牌阵
- **78 张完整塔罗牌** — 22 张大阿卡纳 + 56 张小阿卡纳，正逆位皆有解读
- **牌面图片展示** — 自动显示 Rider-Waite-Smith 公版牌面
- **3 轮对话式体验** — 开场 → 选牌 → 揭牌解读，仪式感与效率兼顾
- **容错式交互** — 用户输入任何格式的数字都能识别，选号有误自动补位

## 牌阵一览

### 单牌（1 张）

| 模式 | 位置 | 适用场景 |
|------|------|----------|
| daily | 今日指引 | 每日抽牌、简单提问 |
| yesno | 是或否 | 封闭式问题（该不该、要不要） |

### 三牌（3 张）

| 模式 | 位置 | 适用场景 |
|------|------|----------|
| time | 过去 → 现在 → 未来 | 时间性问题 |
| problem | 处境 → 挑战 → 建议 | 求建议类 |
| psyche | 意识 → 潜意识 → 指引 | 自我探索 |
| holistic | 身体 → 心理 → 灵性 | 身心平衡 |
| relationship | 你 → 对方 → 关系走向 | 感情/人际关系 |
| choice | 选项A → 选项B → 建议 | 两难选择 |
| growth | 该保留 → 该放下 → 该学习 | 人生转折/成长 |

### 五牌（5 张）

| 模式 | 位置 | 适用场景 |
|------|------|----------|
| timeline | 远过去 → 近过去 → 现在 → 近未来 → 远未来 | 长期规划 |
| cross | 主题 → 障碍 → 过去影响 → 未来趋势 → 核心建议 | 复杂问题深度分析 |
| element | 火·行动 → 水·情感 → 风·思维 → 土·物质 → 灵·指引 | 整体生活检视 |

## 触发方式

在 AI 对话中提到以下关键词即可触发：

> 塔罗、占卜、抽牌、算卦、运势、牌阵、tarot

## 项目结构

```
tarot-guide/
├── SKILL.md                          # AI 主指令文件
├── scripts/
│   └── draw_cards.py                 # 抽牌脚本（洗牌、选牌、正逆位、图片URL）
├── assets/
│   └── cards.json                    # 78 张牌结构化数据
└── references/
    ├── major-arcana.md               # 大阿卡纳牌义（含荣格原型）
    ├── minor-arcana-wands.md         # 权杖牌组牌义
    ├── minor-arcana-cups.md          # 圣杯牌组牌义
    ├── minor-arcana-swords.md        # 宝剑牌组牌义
    ├── minor-arcana-pentacles.md     # 星币牌组牌义
    └── spreads.md                    # 12 种牌阵定义与解读指南
```

## 兼容性

支持以下 AI 代理平台：

- Cursor
- Claude Code (Codex)
- Windsurf
- 其他支持 Agent Skills 的平台

## License

MIT