六爻 Skill Suite

繁體中文 | 简体中文 | English

這是一組針對六爻解卦的 AI skills，用於從既有六爻結果、銅錢記錄或卦名加動爻輸入中建立結構化卦盤，並結合干支日課、進階六爻規則與《周易》文本材料，生成可審計、可降級、非宿命化的傳統文化分析。

本倉庫包含四個可協同使用的 skill：

• liuyao：主入口，負責排盤、工作流編排、用神初判、輸出結構與配套 skill 路由。
• ganzhi-calendar：提供節氣、年/月/日/時柱、月建、日辰、旬空等歷法上下文。
• liuyao-advanced：提供伏神飛神、空破、沖合刑害、墓絕、動變鏈路與候選應期檢查。
• zhouyi-texts：提供 64 卦卦辭、大象、爻辭與動爻取辭規則。

安裝

將 skills/ 內的四個資料夾複製到你的 AI skills 目錄。以下範例使用 AI_SKILLS_DIR 指向目標資料夾：

$env:AI_SKILLS_DIR = "$env:USERPROFILE\.ai\skills"
New-Item -ItemType Directory -Force "$env:AI_SKILLS_DIR" | Out-Null
Copy-Item -Recurse -Force .\skills\* "$env:AI_SKILLS_DIR\"

macOS/Linux 可使用：

export AI_SKILLS_DIR="$HOME/.ai/skills"
mkdir -p "$AI_SKILLS_DIR"
cp -R skills/* "$AI_SKILLS_DIR/"

安裝後，可在支援 skills 的 AI 助手中要求使用 $liuyao，或用自然語言提出「起卦、排六爻、斷卦、取用神、應期」等任務。

快速使用

用六個爻值排盤：

python skills/liuyao/scripts/build_chart.py --yao "7,8,6,9,8,7" --day-stem 甲 --format json

用「本卦 + 動爻 + 變卦校驗」排盤：

python skills/liuyao/scripts/build_chart.py --ben "明夷" --moving "初九,六五,上六" --zhi "漸" --day-stem 壬 --format json

取得干支日課：

python skills/ganzhi-calendar/scripts/ganzhi_calendar.py --datetime "2026-05-08 03:05" --tz +08:00 --pretty

查《周易》文本：

python skills/zhouyi-texts/scripts/zhouyi_lookup.py --ben 明夷 --zhi 漸 --moving 1,5,6 --pretty

驗證

執行跨 skill 冒煙測試：

python skills/liuyao/scripts/integration_smoke.py `
  --calendar skills/ganzhi-calendar `
  --advanced skills/liuyao-advanced `
  --texts skills/zhouyi-texts `
  --pretty

預期輸出包含：

{
  "ok": true
}

也可單獨驗證文本語料：

python skills/zhouyi-texts/scripts/validate_texts.py

設計原則

• 尊重使用者已給出的卦象，不擅自重起卦。
• 使用者明確要求「純網路檢索」或「不要使用本 skill」時，主流程必須讓路。
• 涉及就業、城市、政策、公司、價格等動態現實問題時，應加入可引用資料並分層輸出。
• 六爻分析僅作傳統文化與決策輔助，不替代醫療、法律、投資等專業判斷。
• 腳本輸出採 UTF-8，支援 Windows 中文與卦符輸出。

目錄結構

skills/
  liuyao/
  ganzhi-calendar/
  liuyao-advanced/
  zhouyi-texts/
PRD.md
README.md
README.zh-CN.md
README.en.md

授權

本專案採用 AGPL-3.0 授權，詳見 LICENSE。