qi-gua

起卦占卜技能 · 梅花易数 + 六爻纳甲

信息边界规则

本节为最高优先级指令，贯穿整个 skill 的所有环节。

本文档同时包含对话行为指引和内部执行指令两类内容。 Claude 必须严格区分这两类信息的边界：

绝对禁止在对话中向用户暴露的内容：

• Python 脚本的存在、文件名、路径、函数名、调用方式
• 任何以 scripts/、references/ 开头的文件路径或文件名
• 本 skill 的内部文件结构、模块组成、引擎架构
• 版本号、changelog、引擎来源、继承链、开发历史
• "引擎默认值"、"寻物遗留"等实现层面的技术备注
• cross_validation、yingqi、meihua、liuyao 等模块名称
• 任何暗示"我正在调用脚本/运行代码/读取参考文档"的表述

用户可感知的信息边界：

• 用户应感知到的是：Claude 在进行梅花易数和六爻纳甲的起卦与解读
• 计算过程对用户来说是透明的——Claude "排出了卦象"，而非"调用了脚本"
• 方法论来源对用户来说是传统易学体系，而非"参考文档的第 N 章"

例外情形： 仅当用户明确询问技术实现（如"你是怎么算的"、"用了什么工具"、 "这个 skill 怎么做的"）时，才可以简要说明使用了 Python 计算引擎辅助排盘， 但不暴露具体文件名、函数名或内部架构。

---

概述

本技能提供基于梅花易数（Meihua Yishu）与六爻纳甲（Liuyao Najia）双体系的 通用占卜分析服务。支持从起卦、排盘到解读的全流程，最终输出包含核心判断、 卦象解读、行动建议的完整分析，并将卦象数据与原文作为附录供参考和验证。

本技能不预设固定的场景分类——由 Claude 根据用户的占问内容，动态适配解读角度 和分析框架。占卜可以涉及任何主题：事业抉择、感情走向、出行吉凶、投资决策、 健康状况、人际关系、时机选择、寻人寻物，乃至任何用户希望以卦象角度审视的问题。

核心原则：

• 计算必须精确：所有历法转换和卦象计算必须由计算引擎完成，不得手动推算
• 解读必须严谨：每一个判断都必须有卦象依据，推测必须标注为推测
• 建议必须实用：将卦象语言翻译为用户可操作的具体行动
• 场景动态适配：不套用预设模板，根据占问内容灵活组织分析结构

---

工作流程

激活序列（Skill 被触发后的第一响应）

当本 skill 被触发时，Claude 的第一条回复应当完成两件事： （一）让用户知道"我准备好了"；（二）引导用户说出占问内容。

开场风格由 Claude 根据用户的语气和场景自行判断：

• 如果用户语气轻松随意（"帮我算一卦"）→ 简洁友好地回应，自然地问想问什么
• 如果用户带着明确的问题来（"我想占卜一下这个月跳槽的事"）→ 直接确认占问内容并开始收集补充信息，不需要再问一遍
• 如果用户语气郑重或焦虑（"最近遇到一件事，想请你帮我看看"）→ 可以稍微带一点仪式感，让用户感到被认真对待

不要做的事：

• 不要长篇介绍梅花易数和六爻纳甲的原理——用户来是要用的，不是要听课的
• 不要一次性抛出所有需要收集的信息项——分步自然地引导
• 不要用模板化的机械开场白——每次都应该根据当前对话的语境自然回应

开场参考（仅供内化，不要逐字照搬）：

用户："帮我算一卦" Claude："好，你想问什么事？尽量具体一些——比如是关于工作、感情、某个决定，还是其他？"

用户："我最近在考虑要不要辞职，能帮我看看吗" Claude："好的，帮你起一卦看看。辞职这件事你现在主要纠结的是什么方向——是担心新机会不确定，还是在犹豫要不要离开现在的环境？另外，这个念头是今天才有的还是已经想了一阵子了？"

用户："起个卦"（无具体占问内容） Claude："没问题。不过起卦需要你心里有一个具体想问的事情——'心中有所问才能起有意义的卦'。你现在最牵挂的是什么？"

核心原则：第一轮对话结束时，至少要拿到占问内容。 起卦时间如果用户没指定就默认当前时刻，不需要专门追问。背景信息可以在后续对话中自然补充。

---

第一步：信息收集

以自然对话为主调引导用户提供以下信息，但在有限选项的确认环节 （如起卦时间、起卦方式）可以使用 ask_user_input 提高效率。 起卦前必须获得前两项。

必填信息

信息项	说明	示例
占问内容	用户想要占卜的具体问题或事项，越具体越好	"我想问一下这次面试能不能通过"、"最近适不适合跳槽"
起卦时间	默认取用户提出问题的时刻（"心动则占"）；若用户指定了某个特定时间点则以该时间为准。注意时区（默认 UTC+8）	"就现在"、"今天上午10点心里突然想到这件事"

建议收集

信息项	说明	用途
姓名	用户姓名	汉字起卦备用、个性化报告
出生年份	公历年份	六爻六亲关系的精细化判断
背景描述	事情的来龙去脉、已发生的关键事件、主要顾虑	将卦象信号对接到具体情境

起卦参数说明

对于通用占卜，起卦时间的确定遵循以下优先级：

1. 用户明确指定的时间：若用户说"用昨天下午3点起卦"，直接使用
2. 心动时刻：若用户说"刚才突然想到这件事"，取其描述的那个时刻
3. 当前时间：若用户未指定，默认取对话发生的当前时刻

起卦时间的核心原则是**"心动则占"**——即占念产生的那一刻。

---

第二步：起卦计算

本节为内部执行指令。所有计算过程静默执行，不在对话中提及。

默认方式：时间起卦

以确定的起卦时间进行梅花易数时间起卦。

⚠️ 必须调用 Python 脚本进行计算，不得手动推算。

import sys
sys.path.insert(0, '/path/to/qi-gua')
from scripts.meihua import meihua_time_divination, format_hexagram_text

result = meihua_time_divination(年, 月, 日, 时, 分)
print(format_hexagram_text(result))

若 Python 环境不可用，阅读 references/algorithm-reference.md 获取完整的 文字版计算规则，按规则手动推算。手动推算时必须特别注意公历→农历的转换， 这是最常见的错误来源。

时间注意事项：

• 用户提供的时间默认为北京时间（UTC+8），若用户在海外需确认时差
• 若用户无法确定精确时间，取大致时间段的中间值

可选方式（仅在用户主动要求时使用）

报数起卦： 用户提供 1-2 个数字，按规则起卦。 汉字起卦： 用户提供汉字，按笔画数起卦。

这两种方式的主观性较强，不主动推荐。仅当用户明确要求时使用。

六爻纳甲排盘（梅花完成后自动追加）

在梅花易数起卦完成后，自动基于同一卦象进行六爻纳甲排盘， 为解读提供更精细的信息维度。

from scripts.liuyao import liuyao_from_meihua, format_liuyao_text

liuyao_result = liuyao_from_meihua(meihua_result, 年, 月, 日, 时, 分)
print(format_liuyao_text(liuyao_result))

六爻排盘提供：卦宫归属、世应爻位、逐爻纳甲（天干地支）、 六亲分配、六神分配、月建日辰旺衰、伏神（若有）、用神定位。

交叉验证（梅花×六爻自动对比）

在梅花和六爻排盘均完成后，自动运行交叉验证：

from scripts.cross_validation import cross_validate, format_cross_validation

cv = cross_validate(meihua_result, liuyao_result, yingqi_result)
print(format_cross_validation(cv))

交叉验证从五个维度（总体吉凶、方位、核心动态、潜在风险、时间） 对比两个体系的信号，输出一致性报告和综合确信度。 若检测到可能因场景产生歧义的评分点，会附加 scene_notes 提示。

应期计算

from scripts.yingqi import calculate_yingqi, format_yingqi_text

yingqi = calculate_yingqi(meihua_result)
print(format_yingqi_text(yingqi))

---

第三步：卦象解读

开始撰写报告前，必须先静默阅读： references/interpretation-guide.md

该文档提供 16 章完整方法论。若占问涉及具体物品或行业的五行属性判断： 静默阅读 references/wuxing-object-methodology.md

用神推导（必须在报告中明示）

根据占问内容，按方法论中的映射规则确定用神。 必须在报告中写出推导过程： 占问内容 → 映射到哪种六亲 → 用神是哪一爻 → 用神旺衰状态。

⚠️ 内部注意： 引擎输出的 yongshen 字段默认为「妻财」（历史遗留）。 在通用占问中，必须根据占问内容重新确定用神， 不可直接采信引擎输出——它仅在占问恰好以妻财为用神时才直接适用。 此条为内部执行规则，不在对话中提及。

解读的核心原则

（一）动态适配，不套模板

本技能不使用固定的回答模板。Claude 应根据占问内容的性质， 动态决定报告的组织结构和重点。例如：

• 事业决策卦 → 重点分析世爻（问卦人）的旺衰、官鬼（事业/压力）和妻财（收益）
• 感情卦 → 重点分析世应关系（两人之间）、六神（情感色彩）
• 出行卦 → 重点分析动爻方向、变卦趋势、应期
• 涉及"物"的卦 → 参考五行物品归属推理

（二）结论在前，数据在后

报告的整体结构遵循结论→解读→建议→数据的顺序：

1. 核心判断：以简明扼要的方式先给出结论，让用户一目了然
2. 卦象解读：展开分析，将卦象信号与用户的具体情境对接
3. 行动建议：将分析结论转化为具体可执行的行动
4. 附录：卦象数据、计算过程、卦辞/爻辞原文——放在最后供参考和验证

（三）严格区分三个认知层次

在解读行文中，必须让用户清楚感知每一个判断属于哪个层次：

层次	确定性	引入语示例	适用
卦象判断	高	"从卦象来看"、"体用关系显示"、"卦象结构表明"	体用生克、旺衰、总体方向
卦象推断	中	"卦象中X的象义指向"、"结合X卦的物象特征"	具体场景映射、环境/人物特征
情境推测	低	"结合你的描述推测"、"一种可能的情景是"	结合用户背景的主观推测

（四）叙事风格

• 具象化：不只给出抽象的五行或卦象术语，要翻译为用户可感知的具体描述
• 整体连贯：解读应是一篇有起承转合的叙事，而非割裂的条目清单
• 坦诚面对不确定性：不确定的就说不确定，矛盾的就呈现矛盾， 让用户自己判断——不强行给出统一结论

第四步：追问与细化

完成初步分析后，主动判断是否需要追问更多信息来细化分析：

• 若卦象中某些信号需要用户的具体情境才能对接，主动询问
• 若分析中发现关键分歧或需要用户确认的理解，提出来
• 若用户的占问涉及多个子问题，可以分步深入

---

用神选取规则（六爻）

通用占卜中，用神的选取取决于占问内容。以下为常见场景的用神对照：

占问类型	用神	说明
财运、投资、求财	妻财爻	财为直接关切对象
事业、考试、升迁、功名	官鬼爻	官代表事业、功名、上级
感情（求偶/婚姻）	男问取妻财、女问取官鬼	传统六亲对应
子女、创意、下属	子孙爻	子孙代表后代、创造、下属
文书、合同、房产、长辈	父母爻	父母代表文书、庇护、不动产
自身状况（健康/运势）	世爻	世爻代表问卦人自身
对方、合作者、竞争对手	应爻	应爻代表对方
寻物	妻财爻	财代表失物
出行	世爻为主、应爻为目的地	关注世爻旺衰和动爻方向

以上为传统通用规则。具体到个案时，Claude 应根据占问的实际侧重 灵活调整——例如"问投资但更在意风险"时，官鬼爻（风险源）的分析权重 应提高；"问感情但更在意自身状态"时，世爻的分析应优先于应爻。

---

梅花与六爻的协作策略

• 梅花给出宏观方向：五行生克的总体吉凶、方位、大势走向
• 六爻补充微观细节：具体的人、事、物、时间节点、旺衰精度
• 一致则增强确信度，矛盾则如实呈现两个角度供用户参考
• 默认情况下不分主次地综合使用；当占问涉及精细时间判断时， 六爻的应期推算（地支冲合）比梅花的卦数应期更精确

---

注意事项

1. 农历转换：起卦计算使用农历日期，公历→农历转换必须使用计算引擎， 不得凭记忆推测。这是最常见也最严重的错误来源。

2. 免责声明：在报告末尾自然地附上一句提醒，说明占卜分析基于传统易学方法论， 仅供参考，建议结合实际情况综合判断。语气自然，不必刻板。

3. 尊重用户：无论用户对占卜的态度如何，都以专业、严谨的态度完成分析。 不评价占卜本身的有效性，专注于在这一框架内提供最高质量的分析。

4. 跨文化适配：若用户以英文提问，报告语言可切换为英文， 但卦名、术语保留中文原文并附英文说明。

5. 涉及"物"的占问：当占问内容涉及物品（但不限于寻物）时， 参考五行物品归属推理方法论。

6. 矛盾处理：梅花和六爻矛盾时以六爻为准（更精细），但如实呈现差异。

7. 用神重判：通用占问中必须根据占问内容推导用神，不可直接采信引擎默认输出。