| name | zhouyi-learning |
| description | 周易学习技能：从零开始系统学习周易，包括六十四卦查询、起卦解卦、练习测验、每日一卦和修心指南。采用白话 + 实用的教学方式，适合零基础学习者。 |
| version | 1.0 |
📜 周易学习 Skill v1.0
从零开始系统学习周易的实用工具
一个面向个人学习者的周易学习平台，采用"白话 + 实用"的教学方式，帮助用户从零开始系统掌握周易知识。
🎯 核心功能
1. 六十四卦查询 ⭐
- ✅ 完整数据: 完美 64 卦（无重复、无缺失）
- ✅ 卦象结构: 上下卦、卦德、卦象符号
- ✅ 原文 + 白话: 卦辞爻辞对照解读
- ✅ 多维启示: 修心、事业、健康、人际关系
- ✅ 场景应用: 现代生活实际案例
2. 起卦解卦系统 ⭐
支持三种传统起卦方式：
- 🪙 硬币法: 模拟传统三枚硬币抛掷
- 🔢 数字法: 输入任意数字生成卦象
- ⏰ 时间法: 基于当前时间自动起卦
功能特性:
- ✅ 引导式问题梳理
- ✅ 自动生成变爻标记
- ✅ 初步卦象解读与建议
- ✅ 保存起卦记录便于复盘
3. 练习测验系统 ⭐
- 🧩 八卦识别测验 (8 题): 卦形、元素、特性识别
- 📝 卦名记忆测验 (12 题): 卦辞、核心精神记忆
- 💬 爻辞理解测验 (5 题): 经典爻辞含义理解
- 🎯 案例分析测验 (3 题): 场景适配分析
- 🏆 综合测验 (28 题): 全量完整测试
- 💾 成绩保存: JSON 格式历史记录，支持进度追踪
4. 每日一卦 ⭐
- 📅 精准推荐: 结合农历日期 + 节气 + 干支纪日
- 🌞 节气对应: 惊蛰→震卦、春分→巽卦等
- 💡 核心启发: 根据季节特点提供指导
- 📊 日期信息: 完整显示丙午年正月廿四等信息
5. 基础知识学习
- 🔮 八卦基础: 乾、坤、震、巽、坎、离、艮、兑详解
- ⚖️ 阴阳五行: 理论体系与对应关系
- 📅 天干地支: 六十甲子纪年法
- 🌡️ 24 节气: 节气特点与卦象对应
6. 案例库 (18+ 真实案例)
涵盖六大类应用场景：
- 💼 工作决策: 是否接受 Offer、创业时机选择、职业转型风险评估
- 👥 人际关系: 团队冲突处理、同事关系化解、朋友借钱不还
- 💰 投资理财: 大额投资时机判断、股票止损决策
- ❤️ 感情婚姻: 异地恋分析、婚前犹豫、婆媳关系处理
- 🏥 健康养生: 健身计划坚持困难、手术决策建议
- 📚 学习规划: 考研深造选择、新技能学习方向
7. 修心指南 (18 个核心卦象)
- 🧘 心性修炼: 将卦象智慧转化为日常修行
- 🎯 实践指导: 具体可操作的修心方法
- 📖 18 卦覆盖: 8 个经卦 + 10 个常用卦
🚀 快速开始
方式一：通过 OpenClaw 技能调用（推荐）
"帮我查一下乾卦"
"今天每日一卦是什么？"
"用数字 3 起一卦并解读"
"我想练习测验"
"乾卦修心指南"
"工作选择案例"
方式二：使用交互式主入口
cd ~/.openclaw/workspace/Chinese-Classics-Skills/zhouyi-learning/scripts/
python3 main.py
提供功能:
- 📅 每日一卦
- 🪙 交互起卦解卦
- 🧩 练习测验系统
- 📅 农历干支查询
- 🌡️ 节气查询
- 📚 卦象数据库
- 🧘 修心指南
- 📖 案例库
方式三：使用命令行工具
cd ~/.openclaw/workspace/Chinese-Classics-Skills/zhouyi-learning/scripts/
python3 daily-gua.py
python3 interactive-gua.py
python3 exercise-system.py
python3 get-lunar-ganzhi.py
python3 get-solar-term.py
📁 目录结构
zhouyi-learning/
├── SKILL.md # ⭐ 技能说明文档（本文件）
├── README.md # ✅ 详细使用指南
├── CHANGELOG.md # ✅ 版本变更记录
├── VERSION # 版本号标识 (v1.0)
├── pyproject.toml # Python 项目配置
├── requirements.txt # 依赖列表
├── archive.tar.gz # 历史版本归档
│
├── references/ # 📚 知识库 (188KB)
│ ├── 六十四卦终极版_v11.md # ⭐ 完美 64 卦数据 (88KB)
│ ├── 六十四卦.md # → 符号链接至 v11
│ ├── 修心指南_v3.md # ⭐ 18 卦修心指南 (36KB)
│ ├── 八卦.md # 基础概念 (8KB)
│ ├── 案例库.md # 18+ 案例分析 (40KB)
│ ├── 起卦指南.md # 操作流程 (5KB)
│ └── 卦象关系.md # 卦象关联图谱 (6KB)
│
├── scripts/ # 🛠️ 工具集 (102KB)
│ ├── main.py # ⭐ 交互式主入口 (9.3KB, 264 行)
│ ├── daily-gua.py # ✅ 每日一卦生成器 (15KB, 258 行)
│ ├── interactive-gua.py # ✅ 交互起卦解卦 (12KB, 303 行)
│ ├── exercise-system.py # ✅ 练习测验系统 (18KB, 468 行)
│ ├── get-lunar-ganzhi.py # ✅ 农历干支查询 (15KB, 439 行)
│ ├── get-solar-term.py # ✅ 节气计算器 (9KB, 205 行)
│ ├── zhouyi_database.py # ✅ 统一数据访问层 (14KB, 348 行)
│ └── ... (其他辅助脚本)
│
├── tests/ # 🧪 测试套件
│ ├── run_tests.py # ✅ 测试运行器 (69 行)
│ ├── test_lunar_calendar.py # ✅ 农历计算器测试 (171 行，6 个用例)
│ └── test_core_functions.py # ✅ 核心功能测试 (139 行，5 个用例)
│
└── archive_backup_20260314/ # 📦 历史版本归档
💡 使用示例
示例 1：查询特定卦象
问题: "帮我查一下谦卦"
回答:
📜 谦卦（地山谦）䷎
【卦象】上坤下艮，山在地下，谦虚内敛
【卦辞】谦，亨。君子有终。
【白话解读】谦卑待人，通达顺利。有修养的人能够始终坚持谦德。
【修心启示】
- 保持低调，不炫耀
- 虚心学习他人长处
- 功成不居，德高不傲
【事业建议】
- 团队合作中多倾听
- 成功后归功于团队
- 用谦逊赢得尊重
【爻辞精选】
初六：谦谦君子，卑以自牧也
六二：鸣谦，贞吉
九三：劳谦君子，万民服也
示例 2：每日一卦
问题: "今天每日一卦是什么？"
回答:
📅 2026 年 3 月 15 日 每日一卦
🔮 得卦：火天大有䷍
【日期信息】
- 农历：丙午年正月廿四
- 干支：丙午年 辛卯月 庚辰日
- 节气：惊蛰后第 3 天
【卦象解读】
大有卦象征光明普照、丰收富足...
【今日启示】
今日适合：
✅ 开展新计划
✅ 与人合作
✅ 学习新知识
需注意：
⚠️ 避免因顺利而骄傲
⚠️ 注意细节处理
示例 3：数字起卦
问题: "用数字 88 帮我起一卦"
回答:
🎲 数字起卦：88
【起卦过程】
88 ÷ 8 = 11 余 0 → 上卦为坤（地）
88 ÷ 8 = 11 余 0 → 下卦为坤（地）
【得卦】坤为地䷁
【卦象】六爻皆阴，至柔至顺
【核心含义】
厚德载物，包容万物
【应用建议】
- 以柔克刚
- 顺势而为
- 包容接纳
示例 4：修心指南
问题: "乾卦修心"
回答:
🧘 乾卦修心指南
【核心精神】刚健自强，持续进取
【心性修炼】
1. 培养坚韧不拔的意志
2. 在顺境中保持谦逊
3. 每日自省：是否全力以赴？
【实践方法】
- 晨起立志：设定当日核心目标
- 日中检视：是否偏离初心
- 夜间复盘：今日有何进步
【警示】
- 警惕自满（亢龙有悔）
- 避免急躁（见龙在田前需积累）
- 不可孤傲（需寻求导师指点）
📖 学习路径建议
第一阶段：入门（1-2 周）
第二阶段：基础（2-4 周）
第三阶段：进阶（1-3 月）
第四阶段：精通（3 月+）
🔧 工具说明
main.py ⭐
交互式主入口，带完整菜单系统
python3 main.py
daily-gua.py
生成每日卦象，结合农历、节气、干支
python3 daily-gua.py
python3 daily-gua.py --date 2024-03-15
python3 daily-gua.py --format json
interactive-gua.py ⭐
交互式起卦解卦系统
python3 interactive-gua.py
exercise-system.py ⭐
练习测验系统
python3 exercise-system.py
get-lunar-ganzhi.py
公历 ↔ 农历转换，干支计算
python3 get-lunar-ganzhi.py
get-solar-term.py
24 节气查询与计算
python3 get-solar-term.py
zhouyi_database.py
六十四卦完整数据库，支持程序化查询
from zhouyi_database import get_gua_by_name, get_random_gua
qian = get_gua_by_name("乾")
print(qian['interpretation'])
random_gua = get_random_gua()
❓ 常见问题
Q: 这个技能适合什么样的人？
A: 适合对传统文化感兴趣、想了解周易但不想啃古文的初学者。零基础友好，所有解读都是白话 + 实用建议。
Q: 需要背诵所有内容吗？
A: 不需要。重点是理解逻辑 + 日常使用。数据都在 references/ 里，随时可查。
Q: 每日一卦准确吗？
A: 卦象是算法生成的，"准确"在于你如何理解和应用。重点是通过卦象反思当日状态，不是预测未来。
Q: 可以自定义起卦方式吗？
A: 可以。scripts/ 目录下的脚本都是开源的，你可以修改或扩展。
Q: 如何更新卦象数据？
A: 数据文件在 references/六十四卦终极版_v11.md，如需更新请修改后重新加载技能。
Q: 练习测验的成绩会保存吗？
A: 会。成绩自动保存为 JSON 格式，可以查看历史进度。
🤝 贡献与反馈
如果你发现错误或有改进建议：
- 查看
SKILL.md 了解技能设计逻辑
- 检查
references/ 中的数据源
- 提出具体修改建议
📊 质量指标
| 维度 | 评分 | 说明 |
|---|
| 卦象数据完整性 | ⭐⭐⭐⭐⭐ (5/5) | 完美 64 卦，无重复无缺失 |
| 测试覆盖率 | ⭐⭐⭐⭐☆ (4/5) | 11 个测试用例，100% 通过 |
| 文档完整性 | ⭐⭐⭐⭐⭐ (5/5) | SKILL.md + README.md + CHANGELOG.md |
| 用户体验 | ⭐⭐⭐⭐⭐ (5/5) | 交互式菜单 + 白话解读 + 实用建议 |
📝 版本历史
-
v1.0 (2026-03-25):
- ✅ 完美 64 卦数据（无重复、无缺失）
- ✅ 交互式主入口
main.py
- ✅ 练习测验系统完整上线
- ✅ 修心指南 v3（18 个核心卦象）
- ✅ 测试套件 100% 通过
-
v0.9 (2026-03-14):
- ⚠️ 六十四卦数据存在重复和错误
- ❌ 缺少练习测验系统
- ❌ 无交互式主入口
📄 许可证
本技能仅供个人学习与研究使用。
🌟 记住：周易不是占卜工具，而是修心智慧。
用第一性原理思考，用卦象反思人生。
最后更新：2026-03-25
版本：v1.0
维护者：memory125
仓库地址：https://github.com/memory125/Chinese-Classics-Skills
