## English summary
**Fortune Liuyao** is a self-contained Agent Skill for deterministic Wenwang Najia / Six Lines divination (`六爻`, `文王纳甲`, `京房八宫`). It calculates the original and changed hexagrams, Najia, Six Relations, Six Spirits, Shi/Ying positions, void and broken branches, moving-line transformations, hidden spirits, and auditable rule facts before an AI Agent writes the interpretation.
It works with skill-compatible desktop Agents such as OpenAI Codex, Claude Code, Cursor, WorkBuddy, and other Agent Skills hosts. One local Python command returns the chart data, interpretation prompt, and standalone HTML chart; the current Agent must provide the complete written interpretation directly in chat. Markdown remains internal for review and fact auditing. No Fortune API, API key, web service, npm package, or external Python package installation is required.
Search aliases: **Liuyao Skill**, **Six Lines Divination Skill**, **Wenwang Najia Skill**, **I Ching Agent Skill**, **六爻排盘 Skill**, **三枚硬币起卦**, **京房八宫排盘**.
## 安装
### Agent Skills CLI
```bash
npx skills add shubhaviatiningsih-byte/fortune-liuyao-skill -g -y
```
### GitHub Release 安装包
从 [GitHub Releases](https://github.com/shubhaviatiningsih-byte/fortune-liuyao-skill/releases/latest) 下载 `fortune-liuyao.skill`，再导入支持 Agent Skills 的客户端。
### Git 安装
```bash
git clone https://github.com/shubhaviatiningsih-byte/fortune-liuyao-skill.git
```
仓库根目录就是完整 Skill，包含 `SKILL.md`、确定性脚本、参考方法和展示资源。运行环境只需 Python 3.10+；`lunar_python` 已按 MIT 许可证内置。
## 我们真正想做的事
我们并不想把六爻包装成一种能够代替现实行动的答案，也不认为多塞几本古籍，就能让占卜突然变得“绝对准确”。
六爻首先是一种占问和观察事情的方式。它可以提供另一种理解处境的角度，却不能替你参加面试、经营关系、作出投资决定，或承担现实选择的后果。
我们真正关心的是另一个更具体的问题：**既然越来越多人会让大模型解读六爻，怎样让这次解读少一点想当然，多看见一些真正重要的盘面信息？**
大模型很会组织语言，也见过大量相似内容，但它同样可能：
- 排错纳甲、六亲或世应，却继续给出一篇看似完整的解释；
- 只抓住一个醒目的动爻或卦名，遗漏用神、月日、伏神和其他作用链；
- 把模糊类象直接扩张成具体人事，写出盘面并不支持的细节；
- 给出一个听起来笃定的日期，却说不清这个时间从哪里推出来。
所以我们没有让模型从零开始“猜一张盘”。系统先用程序完成精确排盘，把用神候选、世应、月日、动变、伏神、空破、进退和生克关系逐项展开；再加载项目整理的传统观察顺序和分析方法，作为模型的思考路线；最后对输出进行事实一致性检查，尽量拦住盘面方向写反、依据遗漏和无根据扩张。
我们希望保留大模型原本擅长的综合判断和表达能力，而不是把它锁成一台机械打分器。只是让它在开口之前，**先把该看的看全，把已经算清楚的事实看准，再给出一份更接近真人断盘过程的回答。**
这未必让每一次占问都“更神准”，但会让解读更完整、更有来路，也更值得用户自己复盘。
## 它不只是一个占卜提示词
普通 AI 占卜往往把问题和几个数字直接交给模型自由发挥。这个 Skill 把容易出错、容易遗漏的部分提前做成稳定链路：
| 能力 | 它具体做什么 |
|---|---|
| **确定性排盘** | 计算本卦、变卦、八宫世应、纳甲、六亲、六神、旬空、月破与动变，不让模型猜盘 |
| **细化规则事实** | 展开伏神飞神、回头生克、进退神、冲合刑害、用神候选、多现比较和条件性应期 |
| **传统方法引导** | 按问题领域提醒模型检查用神、世应、月日、动变、伏神、原忌仇神、格局和应期条件 |
| **自由综合解读** | 不用正负计分替代断盘；模型可以运用稳定的京房纳甲知识形成有主次、有结论的报告 |
> **程序负责把盘算准，传统方法负责提醒它该看什么，大模型负责把这些线索真正连成一段判断。**
这意味着，报告仍然可以有明确倾向、有具体解释，而不是充满“也许、可能、仅供参考”的空话；与此同时，盘面基础、判断主线和时间条件也都可以回看与复核。
## 一条开箱即用的链路
```text
用户问题 + 六次起卦结果
↓
确定性排盘：历法 / 纳甲 / 八宫世应 / 六亲六神 / 动变伏神
↓
规则事实：用神候选 / 旺衰证据 / 作用链 / 应期条件
↓
领域方法：事业 / 财富 / 感情 / 学业 / 出行 / 住宅等
↓
综合判断：连接用神、世应、月日、动变与现实语境
↓
聊天中的完整文字解读 + 可选 HTML 可视化卦盘
```
## 30 秒开始一次占问
从 [GitHub Releases](https://github.com/shubhaviatiningsih-byte/fortune-liuyao-skill/releases/latest) 下载 `fortune-liuyao.skill` 并安装，然后直接在 Agent 对话中提出问题。Agent 会用单选弹窗询问自动、逐爻或硬币/爻值起卦；当前客户端不支持弹窗时显示简短文字选项。问题方向、目标和期限优先从文字中理解；问题本身不足以起卦时，Agent 会先询问一个必要的澄清问题。
当前源码版只要求宿主可调用 Python 3.10+；`lunar_python==1.4.8` 已按 MIT 许可证内置。如果宿主 Agent 已内置并允许调用 Python，用户无需另外操作；完全没有 Python 运行时的电脑暂不能执行确定性排盘。可用 `python scripts/run_liuyao.py --selfcheck` 一次检查运行条件、金标盘和展示文件。
不能启动本地网页时，也可以直接告诉智能体：
```text
我想问未来三个月能不能找到合适的工作。
请用一键自动起卦，生成卦盘，并按六爻方法完整解读。
```
也可以让 Agent 逐次记录六轮结果，或把自己线下摇出的六次硬币结果一次性交给 Skill。
无需执行 `pip install`。首次运行可用以下命令检查 Python、内置历法、确定性引擎和渲染器：
```bash
python -S scripts/run_liuyao.py --selfcheck
```
返回 `READY` 后即可使用；`-S` 验证运行过程没有依赖系统 `site-packages`。
## 自己摇硬币也可以
准备三枚相同硬币，连续摇六次。**第一次是初爻，最后一次是上爻。**
本 Skill 采用正面记 3、反面记 2：
| 三枚硬币 | 爻值 | 爻象 |
|---|---:|---|
| 反反反 | 6 | 老阴 · 动爻 |
| 正反反 | 7 | 少阳 |
| 正正反 | 8 | 少阴 |
| 正正正 | 9 | 老阳 · 动爻 |
输入示例：
```text
我问未来三个月能否找到工作。
六次结果从初爻到上爻依次为：
正反反 / 正正反 / 反反反 / 正反反 / 正正正 / 正正反
```
Skill 会先回显为 `[7, 8, 6, 7, 9, 8]`，确认顺序后再排盘，避免上下爻录反。
## 一张卦盘里会算清什么
# Fortune 六爻：AI 六爻排盘与解读 Skill
### 先把每一爻算清楚，再让大模型沿传统方法完整断盘
输入一个问题，选择自动起卦、逐次记录或三枚硬币手动起卦，生成文王纳甲六爻卦盘和完整解读。
