# Fortune Liuyao

> 当用户提出六爻占卜、六爻排盘、文王纳甲、京房八宫、三枚硬币起卦、手动输入六次爻值，或询问事业、感情、财富、学业等六爻问题时使用；英文 Liuyao、Six Lines Divination、Wenwang Najia、I Ching coin casting 也应触发。完成确定性排盘、领域方法加载、当前对话中的完整综合解读、HTML 卦盘交付与事实一致性检查；对高风险医疗、生死、胎儿性别、失踪定位等问题只提供现实帮助。

- **Type:** Skill
- **Install:** `agentstack add skill-shubhaviatiningsih-byte-fortune-liuyao-skill-fortune-liuyao-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shubhaviatiningsih-byte](https://agentstack.voostack.com/s/shubhaviatiningsih-byte)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [shubhaviatiningsih-byte](https://github.com/shubhaviatiningsih-byte)
- **Source:** https://github.com/shubhaviatiningsih-byte/fortune-liuyao-skill

## Install

```sh
agentstack add skill-shubhaviatiningsih-byte-fortune-liuyao-skill-fortune-liuyao-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Fortune 六爻

只执行以下主流程：

**理解问题与语义路由 → 选择起卦方式 → 运行统一入口 → 展示卦盘并完整解读 → 审计明确盘面事实**

确定性脚本负责起卦、历法、排盘、规则事实和展示文件；当前 Agent 负责理解问题、选择领域、调用宿主交互控件，以及依据返回的 `prompt` 完成传统综合判断。锁定盘面事实，不限制无法确定性验证的吉凶、应期和传统推断。

## 1. 理解问题并选择领域

完整阅读 [domain-routing.md](references/domain-routing.md)，根据用户原问题的语义选择以下一个领域，传给统一入口的 `--category`：

`general`、`career`、`wealth`、`relationship`、`academic`、`travel`、`home`、`legal_risk`、`relationship_family`

不要用关键词表代替语义理解。领域只决定加载哪套分析方法，不属于确定性盘面事实。

- 能识别核心事项和用户希望判断的结果：直接继续，不追问可合理留空的信息。
- 问题包含多个需要不同判断主线的独立事项：只问用户本次最想判断哪一个。
- 无法识别所问事项、判断对象或目标结果：暂停起卦，只问一个最必要的澄清问题。
- 问题清晰但领域边界不明确：使用 `general`，不要为了分类追问。

问题清晰度、敏感分流放行、领域路由、脚本状态和校验通过都属于内部过程，成功时不要展示给用户。排盘前不要发送“我会使用本 Skill”“问题已归入某领域”“现在开始运行”等前言；直接执行所需工具。首次面向用户的成功消息从卦盘和解读开始。

### 性别或关系视角

排盘以及事业、财富、学业、出行、住宅、纠纷等领域不需要性别。家庭或代占问题优先理解提问者与被问者的实际关系。

仅当问题属于恋爱或婚姻、用户没有说明视角，并且准备采用“男问妻财、女问官鬼”的传统异性婚恋取用时，才用一个可跳过的问题询问男方、女方或不按性别取用。分别传入 `--perspective male`、`female` 或 `unspecified`。同性关系、非二元身份或用户不愿提供时使用 `unspecified`，结合关系角色与世应分析。

胎儿性别、母婴安危和怀孕结果不是可澄清字段，按安全边界处理。

## 2. 选择并完成起卦

先按 [safety-boundaries.md](references/safety-boundaries.md) 判断；统一入口还会执行确定性分流。被阻止时不排盘，友好转向就医、报警、求助热线或专业咨询等现实帮助。

用户尚未指定起卦方式时，立即使用宿主 Agent 的单选控件提供：

1. 自动起卦
2. 逐爻弹窗
3. 输入硬币或爻值

宿主不支持选择控件时，只发一条简短文字选项。用户选定后立即执行，不再追加“是否开始”。不要另建网页或本地服务模拟弹窗。

### 逐爻弹窗状态机

第一次弹窗显示“生成初爻”。用户点击后运行：

```powershell
python scripts/cast_one_line.py --position 1
```

保存该结果，立即在下一弹窗显示已生成的初爻及“生成二爻”。依次把 `--position` 增加到 6。

- 两次弹窗之间不发送说明、路由、分析或阶段总结。
- 每个位置只运行一次；保存并复用已生成结果，禁止重摇。
- 第六爻完成后不再询问确认，直接把六个值按初爻至上爻传给 `--method lines`。
- 宿主每次提交都要恢复 Agent，允许短暂延迟，但恢复后立即调用下一弹窗。
- 宿主不支持选择控件时，不模拟六轮文字确认；改为让用户一次输入六轮硬币或六个爻值。

硬币换算与顺序完整阅读 [manual-coin-casting.md](references/manual-coin-casting.md)。

## 3. 运行唯一生成入口

先在后台探测当前宿主可用的 Python 命令：Windows 依次尝试 `python`、`py -3`，再检查 Codex 常见内置运行时 `$env:USERPROFILE\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe`；macOS/Linux 依次尝试 `python3`、`python`。使用第一个能返回 Python 3.10+ 的命令继续，并把后续示例中的 `python` 全部替换成该命令；不向用户展示成功的环境探测过程。

如果所有命令都不存在，停止排盘并只提示：“当前 Agent 环境缺少运行排盘引擎所需的 Python 3.10+。请安装 Python 后重试，或换用自带 Python 运行环境的 Agent。”不要让模型临时心算排盘。

再用已探测到的命令运行一次自检，例如：

```powershell
python scripts/run_liuyao.py --selfcheck
```

只有返回 `READY` 才继续。返回 `NOT_READY` 时，只说明缺少的运行条件，不生成半张盘，也不让 Agent 临时重算历法或纳甲。`lunar_python` 已随 Skill 内置，不要求用户执行 `pip install`；若自检仍报告内置依赖缺失，说明安装包不完整，应重新安装 Skill。

自动起卦示例：

```powershell
python scripts/run_liuyao.py `
  --question "未来三个月能否找到合适工作" `
  --category career `
  --method auto `
  --output session.json
```

逐爻或已知爻值使用：

```powershell
python scripts/run_liuyao.py --question "用户原问题" --category general --method lines --lines "7,8,8,6,7,8" --output session.json
```

用户提供六轮硬币时使用 `--method coins --coins "正反反/正正反/反反反/正反反/正正正/正正反"`。

统一入口一次返回：

- `result`：确定性卦盘、规则事实、问题上下文和起卦审计；
- `prompt`：当前 Agent 应直接使用的完整解读上下文；
- `artifacts.html` 与 `artifacts.markdown`：从同一份结果同步生成的展示文件路径；
- `schemaVersion`：输出契约版本。

JSON 和 Markdown 是脚本与 Agent 之间用于保存、复核和事实审计的内部契约。不要向用户粘贴或附加 `session.json`、原始 JSON、`prompt` 或 Markdown 文件；最终用户在当前对话中直接阅读完整解读，HTML 只作为可选卦盘附件。只有用户明确要求导出原始排盘数据时才交付 JSON。

不要再依次调用 `build_chart.py`、`build_model_packet.py` 和 `render_chart.py` 拼接默认流程。它们只作为内部组件和诊断工具。

## 4. 展示并完整解读

最终聊天回复是主要且完整的用户交付物。无论 HTML 是否生成、交付或打开，都必须直接在当前对话中给出完整文字解读：

- 宿主支持文件交付时，把 `artifacts.html` 作为可打开文件链接或附件；不要粘贴 HTML 源码，不要用代码编辑器打开它。
- HTML 始终只是独立的可视化卦盘附件，不能替代、缩短或决定聊天窗口中的完整文字解读。
- 不向用户交付 `artifacts.markdown`；Markdown 只供内部渲染、复核和事实审计。
- HTML 无法交付或打开时，只说明可视化卦盘附件不可用；不要让用户打开 Markdown，也不要反复排查桌面文件关联。聊天中的完整文字解读照常输出。
- 不得把完整文字解读设计成 HTML 的失败降级；它在所有成功排盘中都是必需输出。

完整阅读 [interpretation-modes.md](references/interpretation-modes.md)，直接使用返回的 `prompt` 在当前对话中完成综合解读。不要把 `prompt` 发送给另一个模型，不要求用户提供模型 API 密钥。最终回复不得只给“解读核心”、一句话总结、几条压缩结论或要求用户打开附件查看全文，除非用户明确要求简版。

发送前静默检查：已经直接回答所问，解释了用神、世应、月日和关键动变如何支持结论，覆盖了会实质改变判断的其他结构；用户询问期限时已经回答时间趋势；已经给出现实建议，并把无法确定性验证的内容保持为传统推断。只在内部完成检查，不向用户展示清单、路由、安全分流、脚本状态或审计结果。

传统健康、吉凶、应期和取象可以作为传统推断表达，但不得伪装成确定性盘面字段、医疗诊断或现实专业意见。

## 5. 解读后审计事实

把完整解读保存为 Markdown 或文本后运行：

```powershell
python scripts/verify_facts.py --chart session.json --report report.md --output fact-audit.json
```

校验器只检查报告中明确声称的本卦、变卦、世应、爻位和六亲等确定性字段。发现冲突时修正对应事实；不要删除或压缩无法确定性验证的传统判断。校验通过时保持静默，不向用户展示 `accepted=true` 或内部清单。

最终原样附上：

> 本内容基于玄学体系生成，仅供文化爱好与思维参考，不构成任何重大人生决策的专业建议。

## 按需读取

- 本地运行与错误边界：[runtime-contract.md](references/runtime-contract.md)
- 领域分类：[domain-routing.md](references/domain-routing.md)
- 领域分析方法：[interpretation-modes.md](references/interpretation-modes.md)
- 硬币起卦：[manual-coin-casting.md](references/manual-coin-casting.md)
- 安全边界：[safety-boundaries.md](references/safety-boundaries.md)
- 展示规则：[frontend-contract.md](references/frontend-contract.md)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shubhaviatiningsih-byte](https://github.com/shubhaviatiningsih-byte)
- **Source:** [shubhaviatiningsih-byte/fortune-liuyao-skill](https://github.com/shubhaviatiningsih-byte/fortune-liuyao-skill)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shubhaviatiningsih-byte-fortune-liuyao-skill-fortune-liuyao-skill
- Seller: https://agentstack.voostack.com/s/shubhaviatiningsih-byte
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.