基于梅花易数与六爻纳甲的通用起卦占卜技能。当用户希望通过易学方法进行占卜分析时 触发此技能。触发短语包括但不限于:"帮我起一卦"、"帮我算一卦"、"我想占卜一下"、 "起卦看看"、"帮我卜一卦"、"梅花易数占卜"、"六爻占卜"、"qi gua"、"divination"。 适用于任何占问主题——事业、感情、决策、出行、健康、财运、人际、时机判断等, 不限于特定场景。当用户的意图是通过易学卦象获取分析和指引时,均应触发此技能。
How this skill is triggered — by the user, by Claude, or both
Slash command
/skills-that-work-core:qi-guaThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **本节为最高优先级指令,贯穿整个 skill 的所有环节。**
docs/changelog.mdreferences/algorithm-reference.mdreferences/interpretation-guide.mdreferences/wuxing-object-methodology.mdreferences/yao-ci-complete.mdscripts/__init__.pyscripts/calendar_utils.pyscripts/cross_validation.pyscripts/data_tables.pyscripts/liuyao.pyscripts/liuyao_data.pyscripts/meihua.pyscripts/stroke_count.pyscripts/yao_ci_data.pyscripts/yao_interpreter.pyscripts/yingqi.py本节为最高优先级指令,贯穿整个 skill 的所有环节。
本文档同时包含对话行为指引和内部执行指令两类内容。 Claude 必须严格区分这两类信息的边界:
绝对禁止在对话中向用户暴露的内容:
scripts/、references/ 开头的文件路径或文件名cross_validation、yingqi、meihua、liuyao 等模块名称用户可感知的信息边界:
例外情形: 仅当用户明确询问技术实现(如"你是怎么算的"、"用了什么工具"、 "这个 skill 怎么做的")时,才可以简要说明使用了 Python 计算引擎辅助排盘, 但不暴露具体文件名、函数名或内部架构。
本技能提供基于梅花易数(Meihua Yishu)与六爻纳甲(Liuyao Najia)双体系的 通用占卜分析服务。支持从起卦、排盘到解读的全流程,最终输出包含核心判断、 卦象解读、行动建议的完整分析,并将卦象数据与原文作为附录供参考和验证。
本技能不预设固定的场景分类——由 Claude 根据用户的占问内容,动态适配解读角度 和分析框架。占卜可以涉及任何主题:事业抉择、感情走向、出行吉凶、投资决策、 健康状况、人际关系、时机选择、寻人寻物,乃至任何用户希望以卦象角度审视的问题。
核心原则:
当本 skill 被触发时,Claude 的第一条回复应当完成两件事: (一)让用户知道"我准备好了";(二)引导用户说出占问内容。
开场风格由 Claude 根据用户的语气和场景自行判断:
不要做的事:
开场参考(仅供内化,不要逐字照搬):
用户:"帮我算一卦" Claude:"好,你想问什么事?尽量具体一些——比如是关于工作、感情、某个决定,还是其他?"
用户:"我最近在考虑要不要辞职,能帮我看看吗" Claude:"好的,帮你起一卦看看。辞职这件事你现在主要纠结的是什么方向——是担心新机会不确定,还是在犹豫要不要离开现在的环境?另外,这个念头是今天才有的还是已经想了一阵子了?"
用户:"起个卦"(无具体占问内容) Claude:"没问题。不过起卦需要你心里有一个具体想问的事情——'心中有所问才能起有意义的卦'。你现在最牵挂的是什么?"
核心原则:第一轮对话结束时,至少要拿到占问内容。 起卦时间如果用户没指定就默认当前时刻,不需要专门追问。背景信息可以在后续对话中自然补充。
以自然对话为主调引导用户提供以下信息,但在有限选项的确认环节
(如起卦时间、起卦方式)可以使用 ask_user_input 提高效率。
起卦前必须获得前两项。
| 信息项 | 说明 | 示例 |
|---|---|---|
| 占问内容 | 用户想要占卜的具体问题或事项,越具体越好 | "我想问一下这次面试能不能通过"、"最近适不适合跳槽" |
| 起卦时间 | 默认取用户提出问题的时刻("心动则占");若用户指定了某个特定时间点则以该时间为准。注意时区(默认 UTC+8) | "就现在"、"今天上午10点心里突然想到这件事" |
| 信息项 | 说明 | 用途 |
|---|---|---|
| 姓名 | 用户姓名 | 汉字起卦备用、个性化报告 |
| 出生年份 | 公历年份 | 六爻六亲关系的精细化判断 |
| 背景描述 | 事情的来龙去脉、已发生的关键事件、主要顾虑 | 将卦象信号对接到具体情境 |
对于通用占卜,起卦时间的确定遵循以下优先级:
起卦时间的核心原则是**"心动则占"**——即占念产生的那一刻。
本节为内部执行指令。所有计算过程静默执行,不在对话中提及。
以确定的起卦时间进行梅花易数时间起卦。
⚠️ 必须调用 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获取完整的 文字版计算规则,按规则手动推算。手动推算时必须特别注意公历→农历的转换, 这是最常见的错误来源。
时间注意事项:
报数起卦: 用户提供 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 应根据占问内容的性质, 动态决定报告的组织结构和重点。例如:
(二)结论在前,数据在后
报告的整体结构遵循结论→解读→建议→数据的顺序:
(三)严格区分三个认知层次
在解读行文中,必须让用户清楚感知每一个判断属于哪个层次:
| 层次 | 确定性 | 引入语示例 | 适用 |
|---|---|---|---|
| 卦象判断 | 高 | "从卦象来看"、"体用关系显示"、"卦象结构表明" | 体用生克、旺衰、总体方向 |
| 卦象推断 | 中 | "卦象中X的象义指向"、"结合X卦的物象特征" | 具体场景映射、环境/人物特征 |
| 情境推测 | 低 | "结合你的描述推测"、"一种可能的情景是" | 结合用户背景的主观推测 |
(四)叙事风格
完成初步分析后,主动判断是否需要追问更多信息来细化分析:
通用占卜中,用神的选取取决于占问内容。以下为常见场景的用神对照:
| 占问类型 | 用神 | 说明 |
|---|---|---|
| 财运、投资、求财 | 妻财爻 | 财为直接关切对象 |
| 事业、考试、升迁、功名 | 官鬼爻 | 官代表事业、功名、上级 |
| 感情(求偶/婚姻) | 男问取妻财、女问取官鬼 | 传统六亲对应 |
| 子女、创意、下属 | 子孙爻 | 子孙代表后代、创造、下属 |
| 文书、合同、房产、长辈 | 父母爻 | 父母代表文书、庇护、不动产 |
| 自身状况(健康/运势) | 世爻 | 世爻代表问卦人自身 |
| 对方、合作者、竞争对手 | 应爻 | 应爻代表对方 |
| 寻物 | 妻财爻 | 财代表失物 |
| 出行 | 世爻为主、应爻为目的地 | 关注世爻旺衰和动爻方向 |
以上为传统通用规则。具体到个案时,Claude 应根据占问的实际侧重 灵活调整——例如"问投资但更在意风险"时,官鬼爻(风险源)的分析权重 应提高;"问感情但更在意自身状态"时,世爻的分析应优先于应爻。
农历转换:起卦计算使用农历日期,公历→农历转换必须使用计算引擎, 不得凭记忆推测。这是最常见也最严重的错误来源。
免责声明:在报告末尾自然地附上一句提醒,说明占卜分析基于传统易学方法论, 仅供参考,建议结合实际情况综合判断。语气自然,不必刻板。
尊重用户:无论用户对占卜的态度如何,都以专业、严谨的态度完成分析。 不评价占卜本身的有效性,专注于在这一框架内提供最高质量的分析。
跨文化适配:若用户以英文提问,报告语言可切换为英文, 但卦名、术语保留中文原文并附英文说明。
涉及"物"的占问:当占问内容涉及物品(但不限于寻物)时, 参考五行物品归属推理方法论。
矛盾处理:梅花和六爻矛盾时以六爻为准(更精细),但如实呈现差异。
用神重判:通用占问中必须根据占问内容推导用神,不可直接采信引擎默认输出。
Provides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.
npx claudepluginhub zkbkb/skills-that-work --plugin skills-that-work-core