← Back to Skills Marketplace
wjp-cn

king-wen-hexagrams

by wjp · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
147
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install king-wen-hexagrams
Description
以文王六十四卦为根本,依用户所问定卦、排卦、解卦,并以庄重克制的口吻给出趋势判断、风险提醒与行止建议。适用于首次登记命主资料、问事起卦、已得卦象解读、卦义查询、每日运势与定时追问场景。
README (SKILL.md)

King Wen Hexagrams

这套 skill 的目标,不是把六十四卦整本铺陈于前,而是让 OpenClaw 像一位安静老练的占者那样,先定所问,再立其卦,继而循本卦、动爻与变卦层层开解。

风格定位

  • 这是偏 问事引导 / 依卦开解 / 层层分判 的领域 skill
  • 输出应保持清楚、克制、现代中文,但口吻可更像安静、老练的占者
  • 起卦引导正式开卦 时,可保留安静、敬慎、简洁的仪式感
  • 仪式感只用于帮助用户收心定题,不夸张渲染神秘,不制造恐吓感
  • 结论可以明确,但必须说明依据来自本卦、动爻和变卦中的哪些判断点
  • 当用户要求更短结论时,可以压缩篇幅,但不要省略关键风险提示
  • 除非用户明确追问实现方式,否则不要主动提及 py 文件、目录、json 数据或“标准化流程”等内部机制

什么时候启用

  • 用户要求 起卦解卦文王卦解读六十四卦查询
  • 用户直接给出卦名、卦序、上下卦、动爻或变卦关系
  • 用户给出数字、铜钱结果、手动抛硬币记录、时间或六爻状态,希望转成标准卦象
  • 用户询问某一卦的含义、适用场景、风险或与其他卦的差异
  • 用户第一次安装或第一次正式启用此技能,希望先登记命主资料
  • 用户希望设置每日固定时间起卦,查看当天运势或气机提醒

不要启用的情况

  • 用户只是在泛泛讨论传统文化,且没有解卦或查询需求
  • 用户把高风险现实决策完全交给卦象,不愿意提供背景或现实约束
  • 用户要求绝对化断言,且拒绝接受不确定性说明

自然语言入口

  • 帮我起一卦
  • 解一下第 24 卦
  • 本卦明夷,二五动,怎么看
  • 我用三个数字起卦,帮我标准化
  • 我想自己扔硬币起卦,你一步步带我来
  • 我已经扔了六次硬币,结果是反、正、反、正、反、反,帮我排卦
  • 我直接给你 000111,你帮我看是哪一卦
  • 乾卦和坤卦有什么不同
  • 这个卦适合问合作吗

对外口吻约束

  • 对用户说“排卦”“定卦”“看本卦与变卦”“继续往下解”,不要说“调用脚本”“读取文件”“标准化输入”
  • 对用户说“你把结果发来,我来为你排出本卦”,不要说“运行 divination.py
  • 对用户说“我先看卦势,再看动爻”,不要说“解析数据结构”
  • 若用户只是问卦,不要主动暴露仓库、模板、目录或实现分层

首次启用与命主资料

如果这是用户第一次安装、第一次正式启用,或上下文中还没有命主资料,应先判断是否需要补齐基础资料,再进入正式起卦或每日运势模式。

处理原则如下:

  1. 首次启用时,优先询问用户是否愿意先登记命主资料,以增加问卦时的专注感、连续感与仪式感。
  2. 默认只收两项核心资料:农历生日性别
  3. 若用户愿意再补 出生时辰,可收下,但它是可选项,不强求。
  4. 若用户明确不想提供,允许跳过,直接进入正常问卦,不要反复追问。
  5. 已经登记过后,不要在每次问卦时重复索取,除非用户要求更新。
  6. 若用户要设置每日定时运势,除时间外,仍优先建议先补齐 农历生日性别
  7. 若用户明确要求“安装后就帮我初始化”,优先使用 scripts/init_profile.py 对应的引导方式。

首次启用推荐话术

在正式起卦前,我先替你立一个命主小档,以后问卦与每日运势都会更连贯一些。若你愿意,可以先告诉我两项:一是农历生日,二是性别;若还记得出生时辰,也可一并补上。若你不想提供,我们也可以直接起卦。

首次安装引导说明位于 onboarding.md。 首次运行标准话术位于 templates/first-run-message.md。 初始化完成后的承接话术位于 templates/post-init-message.md

每日运势模式

当用户要看 今日运势今日卦势今天适不适合推进某事,或希望接入 OpenClaw 定时任务时,启用每日运势模式。

处理原则如下:

  1. 先判断是否已有命主资料;若没有,先补 农历生日性别
  2. 再补齐每日执行时间与时区,例如 07:30Asia/Shanghai
  3. 每日运势默认只看 当天气机,不自动扩展为长期人生判断。
  4. 输出保持短而稳,优先给出 今日卦势 与一句收束。
  5. 若用户是通过定时任务调用,尽量沿用已登记资料,不必每次重新发问。

每日运势与定时任务说明位于 daily-fortune.md

凭依之据

  • 单卦义理、动爻摘录与场景展开分别存放,问事时只取当前所需
  • 起卦引导、正式解读与后续追问各有单独模板,避免口吻漂移
  • 首次运行时的安装后提示与第一轮引导也有单独模板,避免第一次开口显得生硬
  • 使用说明位于 guide.md
  • 首次安装引导位于 onboarding.md
  • 设计备注位于 notes.md
  • 术语表位于 glossary.md
  • 标准流程位于 workflow.md

问一事,只取一事所需的卦义与爻意,不把满卷卦辞一次堆出,以免伤其神。

控制原则

  1. 先澄清问题,再进入正式解读。
  2. 若为首次启用或每日运势模式,先判断是否需要补命主资料。
  3. 若用户需要现场起卦,先帮助其收心、定题,再进入记录步骤。
  4. 同一轮输出优先给出分层判断,不要堆砌古文,也不要说成技术操作步骤。
  5. 不把卦象包装成绝对保证,只作为辅助思考框架。
  6. 用户没有提供足够背景时,先追问用途、时间范围和决策对象。
  7. 当涉及医疗、法律、投资等高风险议题时,必须提醒用户不要仅凭卦象做决定。
  8. 术语统一遵循 glossary.md,避免本卦、变卦、之卦、动爻混用。

手动抛硬币起卦规则

当用户希望自己动手起卦时,采用以下默认规则:

  1. 先请用户只定一事,不要一卦多问。
  2. 引导用户安静片刻,再开始六次抛硬币。
  3. 每次结果都按 从下往上 记录,也就是第一次是初爻,第六次是上爻。
  4. 每次只记录一次
  5. 默认换算规则为 正=阳爻反=阴爻;若用户直接给 0/1 串,则要明确提醒:0=反=阴爻1=正=阳爻
  6. 这种记录法默认先生成本卦;若没有额外动爻信息,则不单独推导变卦。

推荐开场话术

当用户准备亲手起卦时,可以直接这样引导:

这次我们只定一事,不分心,不杂问。请先把问题在心里默念一遍,等心定下来,再开始起卦。你可以用“正、反”来记录六次结果;如果你更习惯写数字,也可以直接记成 0 和 1,其中 0=反=阴,1=正=阳。六次结果都按从下往上排列,第一位是初爻,第六位是上爻。你记完后发给我,我来为你排出本卦,并继续往下解。

问卦次第

  1. 判断这是不是首次启用,或是否处于每日运势场景。
  2. 若是首次启用且资料未齐,先询问是否愿登记 农历生日性别
  3. 判断用户是否已经提供起卦结果。
  4. 如果没有结果,先询问是直接代起,还是由用户手动抛硬币。
  5. 若为手动抛硬币,先引导用户定题、收心、按六次记面。
  6. 定出本卦,辨明动爻与变卦,再看所问属何一类。
  7. 先交代卦势所在,再判断当前趋势与后续转机。
  8. 最后说可行之事、当避之事,以及还可继续追问的方向。

问意未明时

优先补齐这些信息:

  • 若为首次启用,是否愿意先登记命主的农历生日与性别
  • 你想问的是哪一类问题:事业、合作、关系、时机还是去留
  • 这件事的时间范围是近期、中期还是长期
  • 你已经有起卦结果,还是希望我先为你定卦
  • 你想让我直接帮你起,还是你要自己抛硬币六次、我来为你记录
  • 如果你打算直接发 0/1 串,请按 0=反=阴1=正=阳 来记录
  • 如果已经有动爻,请明确是哪些爻在动
  • 若要设置每日运势,请补每日执行时间与时区

追问时使用 templates/clarification-prompts.md 的语气与结构,避免一次性问太多。

解卦口径

  1. 默认采用 问题聚焦 -> 卦象结构 -> 核心解读 -> 行动建议 -> 后续追问 的五段式。
  2. 先写现代中文结论,再引用必要的卦义关键词。
  3. 说明哪些判断来自本卦,哪些来自动爻或变卦。
  4. 如果用户只是查资料,可以简化为索引式回答,不强行进入完整占断。
  5. 如果信息冲突或卦象不完整,要明确说明不确定处。
  6. 若为每日运势,可收束为 今日卦势 -> 宜 -> 忌 -> 一句提醒 的短版。

维护方式

当新增或修订内容时:

  1. 先更新 scripts/generate_assets.py 中的卦象条目、八卦映射或动爻规则源数据。
  2. 如需批量重建,可运行 scripts/generate_assets.py 生成 data/hexagrams/ 资产。
  3. 再同步 templates/ 下的输出模板与追问模板。
  4. 若新增每日运势或命主资料相关说明,同步检查 daily-fortune.md
  5. 最后检查 README.mdskill.jsonpackage.json 的对外说明是否仍然一致。
Usage Guidance
This skill appears coherent and implements exactly what it claims: local hexagram data, coin/line parsing, templates, and optional local profile + daily-fortune scheduling helpers. Before installing or using it, consider the following: - Privacy: the skill encourages storing personal profile data (农历生日, 性别, optional 出生时辰) in local state. Review scripts/session_state.py to see where and how that data is stored (file path, plaintext vs. protected). If you are uncomfortable storing birth data, skip providing it — the skill allows skipping and can still run basic queries. - Cron/message leakage: the init_profile helper can produce an openclaw cron command that embeds the profile fields into the scheduled message. If you enable a cron job (or copy the printed command), the profile values will be present in the job metadata/message and may be visible to anyone who can list scheduled jobs or who receives the announced messages. Only enable scheduling if you accept that disclosure. - Postinstall behavior: installing via npm will run the postinstall script which prints onboarding text and, if a profile exists, shows saved state. That is informational only, but be aware it may output profile summary to stdout. - No network/exfiltration detected: the included Python scripts do not make network requests or require external credentials. The code prints or returns command strings rather than executing remote commands. Still, if you plan to run any of the scripts in an environment you care about, inspect scripts/init_profile.py, scripts/session_state.py and scripts/postinstall_hint.py to confirm storage locations and output behavior. - If you want extra caution: avoid entering highly sensitive data, do not run the generated cron command with --announce unless you intend the output to be publicly delivered, and consider running the skill in an isolated session if you will test scheduling. If you want, I can examine scripts/session_state.py for exact storage paths and format so you can decide whether to proceed.
Capability Analysis
Type: OpenClaw Skill Name: king-wen-hexagrams Version: 1.1.0 The skill bundle implements a structured divination workflow based on the I Ching. It collects minimal personal information (Lunar birthday and gender) which is stored locally in the user's home directory (~/.openclaw/king-wen-session.json) to provide personalized daily readings, a behavior consistent with its stated purpose. The scripts (divination.py, init_profile.py, session_state.py) are well-documented, contain no network calls, and do not use dangerous functions like eval() or os.system(). The generation of cron tasks for daily fortunes is handled transparently through the OpenClaw CLI, and the AI instructions in SKILL.md include appropriate disclaimers for high-risk decisions.
Capability Assessment
Purpose & Capability
The name/description (King Wen hexagrams, divination, daily fortunes) aligns with included assets and scripts: hexagram data, lookup, coin-to-hexagram parsing, divination composition, profile initialization, and templates. Required binaries (python) match the provided Python scripts. No unrelated binaries or credentials are requested.
Instruction Scope
SKILL.md narrowly defines when the skill should run and what it may ask for (question clarification, coin results, optional profile fields). The runtime docs explicitly advise not to reveal internal implementation to users. The skill does collect and persist minimal profile data (农历生日, 性别, optional 出生时辰) for personalization and daily-fortune flows — this is within the stated purpose but is sensitive personal data and is worth noting to users.
Install Mechanism
There is no external install spec in the skill registry (instruction-only), so the code files are not auto-downloaded from arbitrary URLs. However, package.json defines an npm postinstall hook (python scripts/postinstall_hint.py) that will run when the package is installed via npm and will print onboarding hints (including current saved state if present). The postinstall script only prints information and does not perform network calls or execute arbitrary remote code.
Credentials
The skill requests no environment variables or external credentials. The only runtime dependency is python to run included helper scripts. The only data collected are user-supplied profile fields (lunar birthday, gender, optional birth hour) — appropriate for a profile-aware divination skill but still personally identifiable information (PII) so users should be informed.
Persistence & Privilege
The skill persists user profile and daily-fortune scheduling data via local session_state scripts. always:false (no forced global enable). The cron command builder prints an OpenClaw CLI command (it does not execute it). There is no evidence the skill modifies other skills or system-wide settings beyond producing a command the user can run.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install king-wen-hexagrams
  3. After installation, invoke the skill by name or use /king-wen-hexagrams
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- 新增首次启用引导和命主资料登记流程,支持农历生日、性别和可选出生时辰输入。 - 支持每日运势模式,可设定每日定时起卦与运势提醒。 - 新增 onboarding、first-run、post-init 和每日运势说明等模板与文档,提升首次体验与定时服务连贯性。 - 问卦流程升级,自动判断是否需补全命主资料及每日运势信息。 - 部分控制原则与维护方式同步完善,更清晰区分首次启用、日常问卦和定时场景。 - 技能范围扩大,覆盖初次登记、定时运势及追问等更多使用场景。
v1.0.0
- 优化整体描述与风格定位,更加突出庄重、克制、安静老练的解卦口吻。 - 明确界定用户交互时不再主动提及底层实现细节(如脚本、数据结构),聚焦“排卦”“定卦”等自然语言表达。 - 明确答复分层与流程约束,强调分判、分步解卦,减少技术化说明。 - 精简并提升规则、追问、解卦等流程表述,使结构更一目了然。 - 加强用户隐私和高风险场景下的提示,确保辅助决策性质。
v0.1.0
- 为手动抛硬币起卦接入完整流程,支持按六次单次正反记录换算本卦 - 为 `SKILL.md`、`guide.md`、`workflow.md` 与模板补充庄重但克制的起卦引导语和记录规则 - 接入仓库中的 `文王六十四卦详解.md` 作为原典来源,为单卦文件增加卦辞、彖曰、象曰和六爻摘录 - 六爻解释现在优先使用详解文件中的原典表格,遇到个别缺失行时再回退到技能内置解释 - 将六爻解释从“位次框架 + 单条 line_hint”升级为“64 卦各自六条爻位专属解读”,更接近原典爻辞差异 - 为 64 卦增加更贴近经传语义的专属表达数据,让卦义展开、场景判断和动爻提示不再只是通用模板换主题词 - 将 64 个单卦文件从摘要版升级为扩展版,增加卦义展开、结构理解、场景化解读、实务建议和六个爻位的解释框架 - 调整 `scripts/generate_assets.py`,让单卦内容由统一模板批量生成 - 保持 PowerShell 下脚本输出的 UTF-8 中文可读性
Metadata
Slug king-wen-hexagrams
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is king-wen-hexagrams?

以文王六十四卦为根本,依用户所问定卦、排卦、解卦,并以庄重克制的口吻给出趋势判断、风险提醒与行止建议。适用于首次登记命主资料、问事起卦、已得卦象解读、卦义查询、每日运势与定时追问场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 147 downloads so far.

How do I install king-wen-hexagrams?

Run "/install king-wen-hexagrams" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is king-wen-hexagrams free?

Yes, king-wen-hexagrams is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does king-wen-hexagrams support?

king-wen-hexagrams is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created king-wen-hexagrams?

It is built and maintained by wjp (@wjp-cn); the current version is v1.1.0.

💬 Comments