灵犀六爻

按中国传统六爻流程执行占卜：随机三钱起卦、排本卦变卦、计算日月建、给出用神与生克判断、生成通俗建议并保存历史。用户提到六爻、起卦、排盘、断卦、用神、空亡、世应或占卜解读时使用。

Security Scan

This skill appears to implement the described 六爻占卜 functionality and its optional LLM integration, but there are a few small inconsistencies and privacy considerations to be aware of before installing.

Purpose & Capability

Name/description match the code and SKILL.md: the script implements coin-toss based 六爻流程, builds 本卦/变卦/用神判定、生成建议并保存历史. The optional LLM enhancement for nicer text is coherent with the stated purpose.

Instruction Scope

Runtime instructions are focused on the divination workflow. Two minor issues: (1) the example invocation references path .cursor/skills/liuyao-divination/scripts/liuyao.py while the included file is scripts/liuyao.py — this is likely an example/path mismatch that may confuse users. (2) The SKILL.md and script save history to a default history file (.cursor/skills/liuyao-divination/history.jsonl), so user questions and generated results are persisted locally unless the user overrides the path.

Install Mechanism

No install spec (instruction-only with a bundled script). Nothing is downloaded from external URLs and no packages are forced to be installed by the skill manifest itself.

Credentials

SKILL.md and the script optionally read OPENAI_API_KEY when --llm is used, but the skill's declared required env vars list is empty — the manifest does not declare this expected credential. Also note that enabling LLM mode will send prompts (user question and gua data) to OpenAI, so the API key and prompt content will be used remotely. The default history file persists user questions/results locally, which may contain sensitive text.

Persistence & Privilege

always is false and the skill is user-invocable only. The skill writes a local history file by default (scoped to .cursor/...), but it does not request elevated/system-wide privileges or modify other skills' configs.

Assessment

This skill does what its description says: local 六爻占卜 with an optional OpenAI-based natural-language explanation. Before installing or running it, consider: (1) If you enable LLM mode (--llm), the script will read OPENAI_API_KEY (not declared in the manifest) and send prompt data to OpenAI — avoid sending sensitive personal data when using that mode. (2) The skill saves history by default to .cursor/skills/liuyao-divination/history.jsonl; review or change the history path if you don't want questions/results persisted. (3) The README example path differs from the included file location; ensure you run the correct script path in your environment. If you want full assurance, inspect the rest of the script (the OpenAI call portion) before enabling --llm and verify the history file handling code behavior.

六爻占卜 Skill

用途

该 Skill 用于执行完整六爻流程，输出结构化结果，并可选调用 LLM 生成更自然的解读文本。

流程要求（必须遵循）

1. 起卦：三枚铜钱摇卦 6 次，自下而上成卦。
2. 排盘：生成本卦、变卦、世应、六亲、六兽。
3. 日月建：根据当前时间推算月建、日辰（简化干支算法）。
4. 断卦：依据用神、生克、冲合、动爻、空亡（简化）给出判断。
5. 解读：将术语翻译为通俗建议。
6. 存储：保存历史卦例用于复盘。

专业版规则引擎（当前实现）

• 纳甲：按上下卦映射六爻地支。
• 六亲：基于宫位五行与爻位地支五行关系判定（兄弟/子孙/妻财/官鬼/父母）。
• 六神：按日干起六神（青龙、朱雀、勾陈、腾蛇、白虎、玄武）顺排六爻。
• 世应：根据本卦与变卦差异映射世应位。
• 旬空：按日柱所在旬推算两空亡支并参与断卦。
• 断卦：对用神爻做评分（旺衰、临月日、发动、世应、旬空、动爻数量）并输出可解释依据。

执行脚本

使用 scripts/liuyao.py：

python .cursor/skills/liuyao-divination/scripts/liuyao.py --question "我该不该换工作"

参数

• --question：占问主题（建议必填）。
• --seed：可复现实验随机种子。
• --llm：启用 LLM 解读增强。
• --model：LLM 模型名，默认 gpt-4o-mini。
• --history：历史保存文件，默认 .cursor/skills/liuyao-divination/history.jsonl。
• --gua-db：卦库 JSON 路径，默认 gua.json。

LLM 解读说明

启用 --llm 时：

1. 读取环境变量 OPENAI_API_KEY。
2. 调用 OpenAI Chat Completions。
3. 若调用失败，自动回退到规则解读，不中断主流程。

输出格式

脚本会输出以下格式：

┌─────────────────────────────────┐
│ 六爻占卜结果                    │
├─────────────────────────────────┤
│ 本卦：{ben_gua.name} {ben_gua.symbol} │
│ 变卦：{bian_gua.name} {bian_gua.symbol} │
├─────────────────────────────────┤
│ 断卦：{judgment}                │
├─────────────────────────────────┤
│ 建议：{advice}                  │
└─────────────────────────────────┘

注意事项

• 该实现为传统流程的工程化专业版，适合咨询与复盘，不替代专业命理师面断。
• 若用户需要更高精度，可继续接入节气历法、月令旺衰细分与伏神飞神规则。