← Back to Skills Marketplace
herberthe

Interpret Fate Via Ziwei

by Herbert He · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
307
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install interpret-fate-via-ziwei
Description
通过紫薇斗数解释命运 A skill to interpret fate using Ziwei astrology principles.
README (SKILL.md)

紫薇斗数

技能描述

本技能通过紫薇斗数的原理来解释命运,提供关于个人命运的见解和建议。用户输入出生日期、时间和地点,系统将根据这些信息进行计算,并输出命运解释、关键人生事件以及相关建议。

环境检查

  • 需要安装 Node.js 版本 18 或更高,如果没有 node 环境需要先进行安装。

执行下面的命令进行检查:

node -v

用户输入

  • 出生日期(需要包含年月日时)
  • 性别(男/女)

输入检查

如果输入不完整或格式错误,系统将提示用户提供正确的信息。

注意事项如下:

  • 需要与用户确认出生日期为12小时制,还是24小时制
  • 需要与用户确认是否闰月

计算出生时辰

根据用户提供的出生时间,系统将计算出对应的时辰。中国传统的时辰划分如下:

时间序号 时辰名称 时间范围
0 子时 23:00 - 00:59
1 丑时 01:00 - 02:59
2 寅时 03:00 - 04:59
3 卯时 05:00 - 06:59
4 辰时 07:00 - 08:59
5 巳时 09:00 - 10:59
6 午时 11:00 - 12:59
7 未时 13:00 - 14:59
8 申时 15:00 - 16:59
9 酉时 17:00 - 18:59
10 戌时 19:00 - 20:59
11 亥时 21:00 - 22:59

为用户输出对应的时辰名称和时间范围。

阅读文献资料

阅读对应的文献资料

  • 星盘介绍 (docs/learn-astrolabe.md)
  • 宫位知识 (docs/learn-palace.md)
  • 星曜知识 (docs/learn-star.md)
  • 四化 (docs/learn-mutagen.md)
  • 格局 (docs/learn-pattern.md)
  • 安星决 (docs/learn-setup.md)
  • 紫薇斗数全书 (docs/learn-ancient-book.md)
  • 诸星问答论 (docs/learn-ancient-book-qa.md)

输出在线排盘地址

https://ziwei.pub/astrolabe/?d=\x3C出生日期,格式为 YYYY-M-D>&t=\x3C时辰序号>&leap=\x3C是否闰月,true 或 false>&g=\x3C性别,male或female>&type=\x3C日历类型,solar 或 lunar>

获取星盘数据和运限数据

  1. 如果用户提供的出生日期为公历(阳历),则使用 node 执行下面的脚本来排星盘。
import { astro } from "iztro"
const timeIndex = 0 // 根据用户提供的出生时间计算出的时辰序号
const isLeapMonth = false // 根据用户提供的信息确定是否为闰月
const astrolabe = astro.bySolar(
  "\x3C出生日期,格式为 YYYY-M-D>",
  timeIndex,
  "\x3C性别,男或女>",
  isLeapMonth,
)

// 获取星盘数据
console.log(astrolabe)

// 获取运限数据
astrolabe.horoscope(new Date())
  1. 如果用户提供的出生日期为农历(阴历),则使用 node 执行下面的脚本来排星盘。
import { astro } from "iztro"
const timeIndex = 0 // 根据用户提供的出生时间计算出的时辰序号
const isLeapMonth = false // 根据用户提供的信息确定是否为闰月
const astrolabe = astro.byLunar(
  "\x3C出生日期,格式为 YYYY-M-D>",
  timeIndex,
  "\x3C性别,男或女>",
  isLeapMonth,
)

// 获取星盘数据
console.log(astrolabe)

// 获取运限数据
astrolabe.horoscope(new Date())

数据字段解释

星盘数据字段说明

字段名 字段含义
solarDate 阳历日期
lunarDate 农历日期
chineseDate 四柱
time 时辰
timeRange 时辰对应的时间段
sign 星座
zodiac 生肖
earthlyBranchOfSoulPalace 命宫地支
earthlyBranchOfBodyPalace 身宫地支
soul 命主
body 身主
fiveElementsClass 五行局
palaces 十二宫数据(数组,见下表)

十二宫数据(palaces)字段说明

字段名 字段含义
name 宫名
isBodyPalace 是否身宫
isOriginalPalace 是否来因宫
heavenlyStem 宫位天干
earthlyBranch 宫位地支
majorStars 主星(含天马禄存,数组)
minorStars 辅星(含六吉六煞,数组)
adjectiveStars 杂耀(数组)
changsheng12 长生12神
boshi12 博士12神
jiangqian12 流年将前12神
suiqian12 流年岁前12神
stage 大限(对象,含range和heavenlyStem)
ages 小限(数组)
majorStars / minorStars / adjectiveStars 结构
字段名 字段含义
name 星名
type 星类型
scope 星所属范围
brightness 星曜状态(如庙、得等,仅majorStars有)

运限数据字段说明

字段名 字段含义
solarDate 阳历日期
lunarDate 农历日期
decadal 大限(十年运)相关数据对象
decadal.index 大限序号
decadal.heavenlyStem 大限天干
decadal.earthlyBranch 大限地支
decadal.palaceNames 大限对应的十二宫名称数组
decadal.mutagen 大限变星(主变星数组)
decadal.stars 大限相关星曜数组
decadal.age 大限年龄对象
decadal.age.index 大限年龄序号
decadal.age.nominalAge 大限虚岁年龄
yearly 流年(年度运)相关数据对象
yearly.index 流年序号
yearly.heavenlyStem 流年天干
yearly.earthlyBranch 流年地支
yearly.palaceNames 流年对应的十二宫名称数组
yearly.mutagen 流年变星(主变星数组)
yearly.stars 流年相关星曜二维数组(每宫一个数组)
monthly 流月(月度运)相关数据对象
monthly.index 流月序号
monthly.heavenlyStem 流月天干
monthly.earthlyBranch 流月地支
monthly.palaceNames 流月对应的十二宫名称数组
monthly.mutagen 流月变星(主变星数组)
daily 流日(每日运)相关数据对象
daily.index 流日序号
daily.heavenlyStem 流日天干
daily.earthlyBranch 流日地支
daily.palaceNames 流日对应的十二宫名称数组
daily.mutagen 流日变星(主变星数组)
hourly 流时(时辰运)相关数据对象
hourly.index 流时序号
hourly.heavenlyStem 流时天干
hourly.earthlyBranch 流时地支
hourly.palaceNames 流时对应的十二宫名称数组
hourly.mutagen 流时变星(主变星数组)

输出星盘数据和运限数据

得到的数据,按照字段的具体含义,为用户输出详细的星盘数据和运限数据。

输出解盘结论

根据星盘数据和运限数据,结合参考资料,为用户提供详细的关于个人命运的见解和建议。

Usage Guidance
This skill appears to be a straightforward Ziwei astrology helper, but before installing or running it you should: 1) Confirm how the 'iztro' dependency is obtained — prefer installing from a known source (npmjs.org) or inspecting the package repository (e.g., the linked GitHub project) and a specific version/hash. 2) Avoid running opaque install scripts: if you must install 'iztro', review its source for any network calls, telemetry, or file-system access; prefer installing in an isolated environment or container. 3) Verify the external URL (https://ziwei.pub) if you plan to open or submit data there; avoid sending personal data to unknown endpoints. 4) Ensure Node.js is installed in a controlled environment (Node 18+ as required). 5) If you want to let an agent invoke this skill autonomously, be aware it could run the Node commands shown — make sure you trust the iztro package code and that no hidden install/download steps are required. If the author or a pinned package version cannot be verified, treat the lack of an explicit install/provenance as a red flag and consider running the computations manually in a sandbox first.
Capability Analysis
Type: OpenClaw Skill Name: interpret-fate-via-ziwei Version: 0.1.1 The skill bundle is a legitimate tool for Ziwei astrology interpretation. It utilizes the open-source 'iztro' Node.js library to calculate astrological charts based on user-provided birth dates and gender. The SKILL.md file contains standard execution logic for an OpenClaw agent, and the extensive documentation in the docs/ directory consists of educational material and excerpts from traditional Chinese astrological texts. No evidence of data exfiltration, malicious execution, or prompt injection was found; the external link (ziwei.pub) is associated with the library's ecosystem.
Capability Assessment
Purpose & Capability
The name/description (Ziwei astrology) aligns with the included docs and runtime instructions that compute a chart from birth date/time/place. However, the SKILL.md examples import and use the npm package "iztro" while the skill declares no install steps or required packages — it's unclear how the agent is expected to obtain that dependency. Requesting Node.js 18+ is reasonable for this purpose.
Instruction Scope
Instructions ask the agent to collect only the user's birth date/time/place, gender, leap-month and 12/24-hour clarifications, and to compute/print astrolabe and horoscope data. This stays within the stated purpose. The SKILL.md also points at an external URL (https://ziwei.pub/astrolabe/?) for online charts — that endpoint is related to astrology and not obviously exfiltratory, but it is external. The instructions do not request unrelated system files or credentials.
Install Mechanism
There is no install specification (instruction-only), which is low-risk normally, but the SKILL.md demonstrates code that imports an external npm package ('iztro') and requires Node.js 18+. The skill does not document how to install 'iztro' (npm install, or a pinned version, or a source repository). That omission makes the runtime environment ambiguous and means the agent or user would likely need to fetch and install code at runtime — something you should verify and control (source, version, integrity).
Credentials
The skill requests no environment variables, no credentials, and no config paths. Its data needs (birth date/time/place and gender) are proportional to its stated function.
Persistence & Privilege
Flags indicate normal invocation (always:false, agent-autonomy allowed). The skill does not request persistent privileges, nor does it instruct modifying other skills or system settings. Autonomous invocation is allowed by default and not itself flagged here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install interpret-fate-via-ziwei
  3. After installation, invoke the skill by name or use /interpret-fate-via-ziwei
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Documentation restructured for clarity and conciseness; headings reorganized and redundant content removed. - "阅读文献资料" (Reference materials) merged and moved up for better visibility in the process. - No changes in code behavior or interface; only documentation reorganized. - Step order and structure improved for easier reading and user guidance.
v0.1.0
Initial release of interpret-fate-via-ziwei: - Provides Ziwei astrology-based fate interpretation using birth date, time, and gender. - Checks for complete and correctly formatted user input, confirming 12/24-hour time and leap month status. - Calculates traditional Chinese "shichen" time slot and displays the matching time range. - Outputs a direct link to the online Ziwei chart based on user input. - Details step-by-step instructions to generate star chart and fate data programmatically using `iztro`. - Explains all output fields for star and fate data. - Guides use of reference materials for interpreting results and producing personalized destiny analysis.
Metadata
Slug interpret-fate-via-ziwei
Version 0.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Interpret Fate Via Ziwei?

通过紫薇斗数解释命运 A skill to interpret fate using Ziwei astrology principles. It is an AI Agent Skill for Claude Code / OpenClaw, with 307 downloads so far.

How do I install Interpret Fate Via Ziwei?

Run "/install interpret-fate-via-ziwei" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Interpret Fate Via Ziwei free?

Yes, Interpret Fate Via Ziwei is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Interpret Fate Via Ziwei support?

Interpret Fate Via Ziwei is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Interpret Fate Via Ziwei?

It is built and maintained by Herbert He (@herberthe); the current version is v0.1.1.

💬 Comments