What it does
紫微斗数命盘解读 skill · 基于 iztro-py 精确排盘,生成可视化命盘 HTML
- Connects Instruction files the AI reads
- Account or key Not confirmed yet (README not read yet)
- Category 自动化与智能体
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/skills/learnwithu-mingli-master)相似的 Skill
同类工作,排序与 Skill 列表相同
Skill 和 MCP 有什么不同
MCP = 手
把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。
Skill = 手册
教 AI 怎么做某项工作的文本文件,不连接任何服务。
有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。
适用的应用
Claude CodeCodexCursor
依据开发者 README 和 repo 中的文件夹
安装
Is it safe?
- Who made it
GitHub account learnwithu (person), 12 years old
- Use and upkeep
★ 786 stars · code last changed 2026年8月15日
- Any scripts?
4 scripts that can run on a computer: scripts/calculate_chart.py, scripts/calibration.py, scripts/generate_html.py, scripts/gezhi_rules.py
- Uses the internet?
No internet calls found in the scripts
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 000da99 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
第一步:你用哪个 AI?
选择你用的应用,本页只显示该应用的安装方法
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (224). Use "Let the AI install it" instead
Option 1让 Claude Code 帮你安装
复制这句话,粘贴到 Claude Code 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
重新打开 Claude Code,输入 /mingli-master,或直接提出相关任务,Claude 会自动选用
Checked against official docs 2026年11月12日 · Source: code.claude.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
开发者推荐的方式
安装 Node.js(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -v- 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
正在检查命令 · 通过后才会显示复制按钮
摘自开发者 README,会下载并运行开发者的代码
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.claude/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
重新打开 Claude Code,输入 /mingli-master,或直接提出相关任务,Claude 会自动选用
ChatGPT 桌面应用
ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill
Option 1让 ChatGPT 帮你安装
在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2自己放入文件夹
把 mingli-master 文件夹放到 ~/.agents/skills/mingli-master
~ 是你的主文件夹($HOME)
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
安装之后
- ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
- 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
- Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
网页版和手机版 ChatGPT
不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill
想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
Option 1让 Codex 帮你安装
复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.agents/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
重新打开 Codex 并提出相关任务,Codex 会列出这个 skill
Option 1让 Cursor 帮你安装
复制这句话,粘贴到 Cursor 的对话中
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
在 Cursor 的 Agent 聊天中输入 / 并选择 mingli-master
Checked against official docs 2026年11月12日 · Source: cursor.com
For Terminal users
Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。
打开终端
Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”
把 skill 文件夹复制到 ~/.cursor/skills
这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹
正在检查命令 · 通过后才会显示复制按钮
在 Cursor 的 Agent 聊天中输入 / 并选择 mingli-master
Option 1Let the AI install it
适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。
已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹
查看原始 SKILL.md
以下文字来自开发者的 repo,不是 PopNx MCP 的指令
6,893 个字符 · 在 GitHub 打开完整文件
---
name: 命理解读师
description: "紫微斗数命盘解读 V2:输入生辰信息,精确排盘并生成可视化命盘解读报告(HTML)。支持格局量化仪表盘、空宫借星标记、流年时空压力热力表,双主题(典藏/赛博)可切换。融合紫微三合派、中州派和手相互证的方法论。当用户提到算命、命盘、紫微斗数、排盘、命理、八字、运势、看命、生辰分析时触发。也适用于用户说「帮我看看命盘」「算一下」「排个盘」「看看运势」的场景。即使用户只是说「帮我分析一下我的性格/事业/感情」,只要上下文暗示需要命理分析,也应该触发。"
---
# 命理解读师 V2
紫微斗数命盘解读 skill。将人的先天时空信息符号化,取象推演,解读生命轨迹。
> **V2 新增**:格局量化仪表盘(第 0 章)· 空宫借星与能量降阶标记 · 流年时空压力热力表(第 6 章)· `--year` 指定任意流年 · 双主题切换
## 核心原则
- **象由心生,命由象推**——不是预言,是概率地图
- **三合为经,中州化忌为纬,手相为实物锚点**
- **算命是对话,不是表演**——沟通比技法更重要
- **命盘显示可能性,行动决定现实**
## 禁忌
- 不预言死亡
- 不制造恐惧
- 不替代决策
- 不说"你一定会",只说"这个格局倾向于"
## 依赖
本 skill 依赖 `iztro-py` Python 库进行排盘计算(≥ 0.5.0)。首次使用前需安装:
```bash
python3 -m pip install iztro-py --user --break-system-packages
```
## 工作流程
### 第一步:信息收集
收集用户提供的生辰信息:
**必须项:**
- 出生年月日(注明农历或公历)
- 出生时辰(如不确定,提供大致时间段)
- 性别
**加分项:**
- 出生地(用于真太阳时校正,可选)
- 手相照片或文字描述(可选,见下方手相互证章节)
用自然语言询问,不要像表单一样列清单。
### 第二步:排盘计算
用 `calculate_chart.py` 脚本进行精确排盘:
```bash
# 公历
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --output /tmp/chart.json
# 农历
python3 scripts/calculate_chart.py --lunar 1991-7-6 --hour 1 --gender 男 --output /tmp/chart.json
# 指定目标流年(默认当前年份;时空压力审计按该年计算)
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --year 2027 --output /tmp/chart.json
# 时辰索引对照:
# 0=早子时(23-00) 1=丑时(01-03) 2=寅时(03-05) 3=卯时(05-07)
# 4=辰时(07-09) 5=巳时(09-11) 6=午时(11-13) 7=未时(13-15)
# 8=申时(15-17) 9=酉时(17-19) 10=戌时(19-21) 11=亥时(21-23)
# 12=晚子时(23-00)
```
脚本输出 JSON 格式的排盘数据,除十二宫星曜、四化、大限外,V2 自动附加:
- `gezhi_analysis`:命宫三方四正格局判定 + 三维量化(风险耐受度/波动恢复力/决策激进度,1-5)
- `time_travel_analysis`:目标流年化忌、大限化忌与生年化忌的叠冲扫描(每宫压力评分)
- 空宫的 `borrowed_major_stars` / `energy_coefficient`(借星安宫与能量降阶标记)
**注意**:`scripts/` 路径相对于本 skill 目录(`~/.claude/skills/mingli-master/scripts/`)。
### 第三步:解读命盘
读取排盘 JSON 数据后,按照以下结构生成解读文字:
1. **命盘底色**(先天禀赋、性格底层)—— 重点分析命宫主星(若空宫则借对宫星曜,能量打七折;对宫见煞则五折)
2. **事业**(官禄宫)—— 职业倾向、适合路线
3. **财运**(财帛宫)—— 财运模式、积累方式
4. **感情**(夫妻宫)—— 缘分时机、感情模式、伴侣特征
5. **当前大限**—— 此阶段核心课题与机遇风险
6. **近三年流年**—— 具体年份的重要节点提示(可选)
解读时参照 `references/interpretation_guide.md` 中的风格指南和 `references/stars_reference.md` 中的星曜参考。
**关键要求:**
- 解读要有**主见和判断**,不要模棱两可
- 用**类比和日常语言**翻译术语
- 先承认格局的积极面,再指出需要注意的地方
- 不要写成教科书,要写成"跟朋友聊天"的语气
**V2 提示:** 第 0 章(宏观格局仪表盘)和第 6 章(时空压力热力表)由 HTML 生成器从 `gezhi_analysis` / `time_travel_analysis` 自动渲染,**解读文字不用写这两章**。但解读时应阅读这两个字段:格局判定(如杀破狼/机月同梁)是解读基调的锚,时空压力热点(压力分 ≥2.5 的宫位)值得在流年提示中自然带出。
### 第四步:生成解读数据 JSON
将解读内容整理成 `reading.json` 格式:
```json
{
"current_decadal_branch": "当前大限所在宫位的地支(如'辰';留空则自动从排盘数据定位)",
"current_decadal_display": "当前大限展示文字(如'辰宫·天机·天梁';留空则自动生成)",
"cards": [
{
"title": "命盘底色 · 先天禀赋",
"badge": "主星名称(如'紫微·贪狼')",
"full": true,
"highlight": true,
"body": "解读正文,支持 HTML 标签:<strong>强调</strong> <em>金色文字</em> <span class='warn'>警告</span> <span class='good'>利好</span>",
"probabilities": [
{"label": "推算置信度", "pct": 70},
{"label": "校准后可达", "pct": 85}
]
}
],
"hand_reading": { "items": [] },
"calibration_questions": [
{"text": "问题文本", "hint": "补充说明"}
]
}
```
**cards 的样式变体:**
- `full: true` — 全宽卡片(用于命盘底色、当前大限等重点章节)
- `highlight: true` — 红色边框高亮
- `teal: true` — 青色边框高亮(用于时空压力审计第 6 章)
- 省略则使用默认样式
**body 正文的 HTML 标签:**
- `<strong>` — 白色强调
- `<em>` — 金色强调
- `<span class="warn">` — 橙色警告文字
- `<span class="good">` — 绿色利好文字
- `<br>` — 换行
### 第五步:生成 HTML 命盘
```bash
# reading.json 为空结构也可以运行(第 0/6 章自动注入,出"骨架盘")
echo '{"cards": [], "hand_reading": {"items": []}, "calibration_questions": []}' > /tmp/reading.json
python3 scripts/generate_html.py --chart /tmp/chart.json --reading /tmp/reading.json --output /tmp/mingpan.html
```
生成的 HTML 文件是完整的可视化命盘,浏览器直接打开。**页面右上角可切换「典藏」(金黑古典)/「赛博」(发光卡片)双主题**,选择会记住。
### 第六步:手相互证(可选)
如果用户提供了手相照片或文字描述,在解读中增加手相互证部分。
**多模态模式(用户提供照片):**
1. 分析手相照片中的主要掌纹特征
2. 提取生命线、智慧线、感情线的走向和深浅
3. 与命盘进行交叉比对
**描述模式(用户用文字描述):**
引导用户描述以下特征:
- 生命线:弧度大小、长度、清晰度
- 智慧线:起点位置、走向(平直/下弯)、长度
- 感情线:深浅、终点位置(食指/中指/无名指下方)
- 掌纹:整体是粗线简洁还是细纹多
- 掌型:手掌偏长还是偏宽,手指粗细
**纯命盘模式(不提供手相):**
跳过手相部分,不生成手相互证章节(reading.json 中省略 `hand_reading` 字段)。
**hand_reading items 格式:**
```json
{
"title": "生命线",
"body": "描述内容",
"status": "match" 或 "conflict",
"status_text": "与命盘XX共振 ✓" 或 "与XX有表面矛盾",
"resolution": "仅 conflict 时需要:解释取舍逻辑"
}
```
## 校准机制
解读完毕后,在命盘末尾加入校准问答。用户回答后,可以修正取象偏差,将准确度从 65-75% 推向 85% 以上。完整题库见 `scripts/calibration.py`(含优先级、对应命盘关键点与回答示例)。
**标准校准问题(按优先级选用 3-5 个):**
1. **感情/婚姻(必问)**
- 你的感情/婚姻状态属于哪种?(稳定/波折/单身/其他)
- 如果已婚/有伴侣,有没有重大感情事件?(如:结婚年份、近年有无变动)
2. **财务状况(必问)**
- 最近1-2年财务状况如何?(如:收入变化、投资损益、负债、理财收益等)
3. **事业/工作模式(选问)**
- 目前从事的行业或工作性质?(打工/创业/自由职业/投资理财为主)
4. **生活变化(选问)**
- 最近1-2年有没有明显的生活变化或压力来源?(换城市、生活节奏变化、经济压力、家庭成员变动等)
5. **健康/困扰(选问)**
- 有没有明显的身体不适或反复出现的健康问题?
- 你最困扰的事情是什么领域?
- 父母中哪一方影响你更深?
**校准后的解读调整:**
| 命盘关键点 | 用户回答 | 解读调整方向 |
|-----------|---------|-------------|
| 夫妻宫/大限转换 | 感情变动年份 | 确认感情解读准确度↑ |
| 财帛宫+铃星/擎羊 | 投资亏损/收入锐减 | 财务解读确认准确度↑ |
| 官禄宫组合 | 创业/打工模式 | 事业解读校准 |
| 整体格局 | 大运时间节点 | 验证时间节点预测 |
## 输出格式
### 双轨输出
1. **专业层**:术语 + 星曜 + 宫位 + 四化路径(给懂行的看)
2. **白话层**:类比日常语言翻译,避免术语堆砌
### 手相互证标注
- 标注与星盘吻合/矛盾之处
- 矛盾处说明取舍逻辑
## V2 自动增强组件
以下组件由脚本从排盘数据**确定性计算**并自动渲染,不依赖解读文案:
| 组件 | 位置 | 数据来源 | 内容 |
|------|------|---------|------|
| 宏观格局仪表盘 | cards 头部 | `gezhi_analysis` | 格局判定 + 技术别名 + 描述 + 三维量化进度条(1-5) |
| 空宫借星标记 | 十二宫格 | 空宫 `borrowed_*` 字段 | 虚线边框 + 借星斜体"(借)" + 能量系数标签(0.5红/0.7橙/1.0绿) |
| 时空压力热力表 | cards 尾部 | `time_travel_analysis` | 流年干支 + 流年/大限/生年化忌叠冲,每宫压力分(≥2.5 高危热点,≥1.5 预警) |
**判定规则的单一事实来源**是 `scripts/gezhi_rules.py`:格局分类器(杀破狼/紫府武相/机月同梁/阳梁昌禄/巨日同宫/马头带剑/杂格)、空宫能量降阶(0.7/0.5)、四化忌星表(已按标准生年四化校验修正)。
## 参考文件
| 文件 | 何时读取 |
|------|---------|
| `references/stars_reference.md` | 解读命宫、事业、财运、感情时,查阅相关星曜的解读参考 |
| `references/four_hua_reference.md` | 分析四化飞星时查阅 |
| `references/interpretation_guide.md` | 首次使用本 skill 时读取,了解解读风格和语气要求 |
| `scripts/gezhi_rules.py` | 需要解释格局判定或量化指标的计算规则时查阅 |
| `scripts/calibration.py` | 组织校准问答时查阅完整题库(优先级/关键点/回答示例) |
## 完整示例流程
```bash
# 1. 排盘(含格局扫描 + 流年压力审计)
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --output /tmp/chart.json
# 2. 读取 chart.json,分析命盘,生成 reading.json(由 LLM 完成)
# 3. 生成 HTML(即使 reading.json 为空,也会自动注入第 0/6 章组件)
python3 scripts/generate_html.py --chart /tmp/chart.json --reading /tmp/reading.json --output /tmp/mingpan.html
# 4. 在浏览器中打开 mingpan.html 查看命盘,右上角切换主题
```
## 文件结构
```
mingli-master/
├── SKILL.md # 本文件 V2
├── README.md
├── scripts/
│ ├── calculate_chart.py # 排盘引擎(iztro-py + V2 后处理管线)
│ ├── generate_html.py # HTML 生成引擎(空宫渲染/第0/6章注入/主题变量)
│ ├── gezhi_rules.py # 格局判定与量化规则(判定规则单一事实来源)
│ └── calibration.py # 校准问题库(优先级/关键点/回答示例)
├── templates/
│ └── chart_template.html # HTML 模板(典藏主题 + 赛博增强层 + 切换器)
└── references/
├── stars_reference.md # 星曜解读参考
├── four_hua_reference.md # 四化参考
└── interpretation_guide.md # 解读风格指南
```
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
来自 GitHub
- GitHub 星标
- 786
- 开发者
- learnwithu
- 许可证
- MIT
- 最近代码更新
- 2026年8月15日
- repo 中的 SKILL.md 文件(含译本和模板)
- 1
- 主题
- agent-skill, chinese-astrology, claude-skill, fortune-telling, iztro, ziwei, ziwei-doushu