# Xiaoliuren Divination

> 小六壬占卜工具，自动获取当前农历时间起卦（支持报数起卦），结合六神吉凶、五行生克、天干地支应期综合解卦。当用户想要占卜、算卦、问吉凶、求签、预测运势，或提到"小六壬"、"六壬"、"掐指一算"、"帮我算一卦"，或调用 $xiaoliuren-divination 时触发此技能。

- Skill: `caoxicheng/xiaoliuren-divination` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add caoxicheng/xiaoliuren-divination`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caoxicheng/xiaoliuren-divination/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caoxicheng (https://skillmd.com/u/caoxicheng)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/caoxicheng/xiaoliuren-divination

---


# 小六壬占卜

小六壬是中国传统的简易占卜术，通过农历月、日、时辰推算吉凶。本技能支持时间起卦与报数起卦，并提供六神详解、五行生克、天干地支应期的完整解卦流程。

## 依赖

```bash
pip install lunar-python
```

## 起卦方式

### 方式一：时间起卦（默认，优先使用）
直接运行脚本，自动取当前时间：

```bash
python scripts/xiaoliuren.py
```

默认以时间起卦；同一时辰内用户多次问卦会得到同一卦象，属正常现象。

### 方式二：报数起卦（用户主动要求时使用）
用户心里默想问题，随口报 1~3 个正整数，或明确说"报数算"：

```bash
python scripts/xiaoliuren.py --numbers 3 7 15
```

- 报 1 个数：从大安起顺数，落宫即主卦（单宫直断）
- 报 2 个数：第一个起月宫、第二个起日宫，时宫用当前时辰
- 报 3 个数：第一个起月宫、第二个起日宫、第三个起时宫

### 指定时间起卦（用户要求按某时刻算时）
```bash
python scripts/xiaoliuren.py --datetime 2026-08-07_08:00
```

## 起卦规则说明

- **闰月**：按本月数参与计算（主流简化法，如闰六月按六月算）
- **子时换日**：23:00 之后起卦，农历日按次日计算（晚子时属次日）

## 解卦流程

1. **定主卦**：以时宫（主卦）定吉凶基调
2. **看三宫**：月宫看大环境、日宫看近期、时宫看当下结果
3. **五行生克**：看相邻宫位五行生克修正吉凶（吉神逢生更吉、凶神逢克有转机，详见 references/ganzhi-wuxing.md 第三节）
4. **天干地支**：结合当日日干支与主卦五行论生克，用六宫地支断应期（日加时断法）
5. **结合事项**：识别用户问题关键词，查 references/matter-readings.md 给针对性解读

## 六神速查表

| 六神 | 五行 | 方位 | 地支 | 基本含义 | 吉凶 |
|------|------|------|------|----------|------|
| 大安 | 木 | 东方 | 寅 | 稳定安宁、贵人相助 | 吉 |
| 留连 | 木 | 东方 | 卯 | 拖延纠缠、暧昧不明 | 平 |
| 速喜 | 火 | 南方 | 巳 | 喜事临门、快速好消息 | 吉 |
| 赤口 | 金 | 西方 | 申 | 口舌是非、争执凶险 | 凶 |
| 小吉 | 水 | 北方 | 亥 | 小有收获、女性贵人 | 小吉 |
| 空亡 | 土 | 中央 | 戌 | 落空虚无、事不成 | 凶 |

## 事项关键词映射

| 关键词 | 事项分类 |
|--------|----------|
| 桃花、对象、恋爱、感情、结婚、姻缘 | 婚姻感情 |
| 钱、财、投资、赚、亏、生意、财运 | 求财 |
| 出门、出行、旅游、出差、回家、行程 | 出行 |
| 病、身体、健康、医院、手术、康复 | 疾病健康 |
| 丢、找、失物、东西不见、遗失 | 失物寻找 |
| 官司、诉讼、打官司、纠纷、法律 | 诉讼官司 |
| 考试、面试、学习、升学、成绩 | 考试学业 |
| 工作、升职、跳槽、辞职、事业 | 事业工作 |

## 输出格式

```
【起卦时间】
公历：YYYY年MM月DD日 HH:MM
农历：X年X月X日 X时
干支：XXXX年 XX月 XX日 XX时

【卦象结果】
月宫：[六神]
日宫：[六神]
时宫：[六神]（主卦）

【五行生克】
月宫[五行] → 日宫[五行] → 时宫[五行]
[生克关系分析]

【综合解读】
[基于三宫六神、五行生克、干支应期的分析]

【吉凶判断】
整体：[大吉/吉/平/凶/大凶]

【建议】
[针对性建议]
```

## 参考文档

- **六神详解**：`references/liushen-details.md` - 各六神的详细含义、断语口诀
- **事项解读**：`references/matter-readings.md` - 各类事项的针对性解读指南
- **干支五行**：`references/ganzhi-wuxing.md` - 六宫配天干地支、五行生克断法、日加时断应期、六神寄宫