mingyu-skill
gaowei90098-creator/mingyu-skill
Claude Code and Codex skill for Bazi and Zi Wei chart analysis
Instalação
npx convez-ai gaowei90098-creator/mingyu-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
What Is Mingyu Skill
命语 Skill 是一个面向 Claude Code 和 Codex 的 AI 命理协作 Skill。它不是一个网页应用,也不是单纯的提示词文件,而是一套可安装、可引用、可运行脚本验证的 agent 工作流。
它帮助 AI agent 在处理八字、紫微斗数、命盘解读、财富分析、命理产品开发时,遵循同一套规则:
- 先锁定排盘事实,再进入解释。
- 区分八字大运、紫微大限和流年,不混用系统。
- 对财富、事业、感情等主题使用多层证据,不用单点断语。
- 保持温和、克制、可验证的表达方式,避免恐吓式算命。
- 在缺少依赖或出生信息时明确说明不确定性。
One-Line Install
默认同时安装到 Claude Code 和 Codex:
curl -fsSL https://raw.githubusercontent.com/gaowei90098-creator/mingyu-skill/main/scripts/install.sh | bash
只安装到 Codex:
curl -fsSL https://raw.githubusercontent.com/gaowei90098-creator/mingyu-skill/main/scripts/install.sh | bash -s -- --target codex
只安装到 Claude Code:
curl -fsSL https://raw.githubusercontent.com/gaowei90098-creator/mingyu-skill/main/scripts/install.sh | bash -s -- --target claude
同时安装可选排盘脚本依赖:
curl -fsSL https://raw.githubusercontent.com/gaowei90098-creator/mingyu-skill/main/scripts/install.sh | bash -s -- --with-deps
如果你像维护其他开源 skill 一样,想手动复制标准目录:
cp -R codex/skills/mingyu ~/.codex/skills/mingyu
cp -R claude-code/skills/mingyu ~/.claude/skills/mingyu
安装后可以直接对 agent 说:
Use $mingyu to read this birth chart.
或:
使用 mingyu skill 帮我分析这个八字和紫微命盘。
Core Capabilities
| Module | What It Does | Typical User Prompt |
|---|---|---|
| Bazi chart facts | 四柱、日主、纳音、命宫、身宫、胎元、起运、大运链 | 帮我排八字 |
| Bazi analysis | 日主旺衰、十神、五行、调候、格局、喜用神、大运流年 | 这个盘身强还是身弱?用神是什么? |
| Zi Wei chart facts | 十二宫、命宫、身宫、五行局、主星辅星、四化、大限 | 帮我看紫微命盘 |
| Zi Wei analysis | 三方四正、对宫借星、宫位证据、大限与流年分层 | 我的财帛宫和官禄宫怎么样? |
| Wealth framework | 财位四宫、成格判断、生年四化、八字担财、大运曲线 | 我这个盘财富等级如何? |
| Product collaboration | 命语/水滴语气、命盘展示、AI 命理产品体验、代码维护 | 帮我优化命理 AI 的系统提示词 |
Workflow Architecture
User birth info or chart question
|
v
Mingyu Skill
|
+-- references/ domain rules loaded as needed
| +-- wuxing-tables.md stems, branches, hidden stems, ten gods
| +-- shichen-table.md Chinese hours and hour stem rules
| +-- dayun-rules.md luck cycle and annual flow rules
| +-- classical-texts.md classical interpretation references
| +-- project-guide.md Mingyu product/code collaboration guide
|
+-- scripts/ optional deterministic helpers
| +-- calculate_chart.py Bazi JSON helper using lunar-python
| +-- calculate_ziwei.cjs Zi Wei JSON helper using iztro
|
v
Fact lock: pillars, day master, palaces, mutagens, da-yun, decadal cycles
|
v
Layered interpretation: Bazi + Zi Wei + topic-specific evidence
|
v
Warm, bounded, non-fatalistic answer
Recommended Usage Flow
Flow A: Pure Skill Mode
This is the default mode for most Claude Code and Codex users.
Step 1: Install the skill.
Step 2: Ask the agent to use $mingyu.
Step 3: Provide birth data or an existing chart.
Step 4: The agent reads SKILL.md and references/ to guide analysis.
No Python or Node dependency is required in this mode.
Flow B: Deterministic Chart Mode
Use this when you want the agent to run local chart helpers.
python3 scripts/setup_env.py
npm test
Then run:
python3 scripts/calculate_chart.py --year 1995 --month 8 --day 15 --hour 14 --minute 30 --gender 男
printf '{"birthday":"1995-08-15","time_idx":7,"gender":"男"}' | node scripts/calculate_ziwei.cjs
Windows PowerShell:
'{"birthday":"1995-08-15","time_idx":7,"gender":"男"}' | node scripts/calculate_ziwei.cjs
Input Requirements
| Input | Required | Notes |
|---|---|---|
| Solar birth date | Yes | YYYY-MM-DD preferred |
| Birth time | Yes for full chart | If unknown, state uncertainty and avoid over-reading hour-sensitive parts |
| Gender | Yes for da-yun direction and Zi Wei conventions | Supports 男/女, male/female |
| Birthplace | Recommended | Useful when discussing true solar time |
| Existing chart JSON | Optional | Agent can analyze already generated chart data |
Analysis Guardrails
Mingyu Skill is designed to reduce common AI metaphysics mistakes:
| Risk | Guardrail |
|---|---|
| Mixing 八字大运 and 紫微大限 | Treat them as separate systems and label them clearly |
| Moving finished cycles into the future | Lock full da-yun and decadal cycle sequence before interpretation |
| One-palace wealth judgment | Require wealth analysis across 财帛、田宅、福德、官禄 plus 八字担财 |
| Overconfident prediction | Use tendency, evidence, and uncertainty instead of fatalistic claims |
| Missing dependency | Continue in pure Skill mode and disclose that deterministic scripts were not run |
| Health/legal/financial overreach | Keep outputs as cultural and reflective guidance, not professional advice |
Technical System
| Layer | Choice |
|---|---|
| Skill format | SKILL.md plus references, scripts, and Codex metadata |
| Claude Code install path | ~/.claude/skills/mingyu or project .claude/skills/mingyu |
| Codex install path | ~/.codex/skills/mingyu |
| Bazi helper | Python 3.9+ with lunar-python |
| Zi Wei helper | Node.js 18+ with iztro |
| Environment setup | python3 scripts/setup_env.py |
| Deterministic validation | python3 scripts/validate.py or npm test |
| Codex metadata | agents/openai.yaml |
| License | MIT |
The Zi Wei helper uses Node iztro because it is easier to install across agent environments and avoids Python py_iztro/pythonmonkey thread stability issues seen in some runtimes.
Accuracy And Validation
Mingyu Skill treats chart calculation as a deterministic helper, not as an LLM guessing task.
Current validation fixture:
| Case | Expected |
|---|---|
| Solar birth | 1995-08-15 14:30, male |
| Bazi pillars | 乙亥 甲申 戊寅 己未 |
| Day master | 戊 |
| Zi Wei Chinese date | 乙亥 甲申 戊寅 己未 |
| Zi Wei palaces | 12 palaces |
| Key mutagens | 天机化禄、太阴化忌、紫微化科、天梁化权 |
Run validation:
python3 scripts/setup_env.py
python3 scripts/validate.py
This verifies:
- Bazi helper returns the expected four pillars, day master, and da-yun chain.
- Zi Wei helper returns the expected Chinese date, 命宫/身宫, 12 palaces, and key mutagens.
- Script dependencies are installed and executable in the current environment.
For production-grade use, add your own fixtures in scripts/validate.py and compare outputs against trusted calendars or existing chart data.
Project Structure
mingyu-skill/
├── SKILL.md # Skill entry point
├── CHANGELOG.md # Version history
├── codex/skills/mingyu/ # Ready-to-copy Codex skill package
├── claude-code/skills/mingyu/ # Ready-to-copy Claude Code skill package
├── agents/openai.yaml # Codex UI metadata
├── references/
│ ├── project-guide.md # Mingyu product/code collaboration guide
│ ├── wuxing-tables.md # Five elements, stems, branches, ten gods
│ ├── shichen-table.md # Chinese hours and hour stem rules
│ ├── dayun-rules.md # Luck cycle and annual flow rules
│ └── classical-texts.md # Classical interpretation summaries
├── scripts/
│ ├── install.sh # One-line installer
│ ├── setup_env.py # Optional dependency setup/check
│ ├── validate.py # Deterministic chart validation
│ ├── calculate_chart.py # Bazi chart helper
│ └── calculate_ziwei.cjs # Zi Wei chart helper
├── requirements.txt
├── package.json
└── LICENSE
Version History
| Version | Date | Highlights |
|---|---|---|
| v1.1.0 | 2026-06-10 | Codex/Claude ready-to-copy skill directories, environment setup script, deterministic validation script, and accuracy documentation. |
| v1.0.0 | 2026-05-19 | First stable release. One-line installer, Claude Code/Codex support, Bazi helper, Zi Wei helper, domain references, Codex metadata. |
| v0.3.0 | 2026-05-19 | README polished for public GitHub usage, installation script added, repository topics configured. |
| v0.2.0 | 2026-05-19 | Compatibility pass: clear dependency model, npm test, friendly dependency errors. |
| v0.1.0 | 2026-05-19 | Initial extraction from Mingyu project into standalone skill package. |
See CHANGELOG.md for details.
Manual Installation
Project-level Claude Code:
mkdir -p .claude/skills
git clone https://github.com/gaowei90098-creator/mingyu-skill .claude/skills/mingyu
Global Claude Code:
mkdir -p ~/.claude/skills
git clone https://github.com/gaowei90098-creator/mingyu-skill ~/.claude/skills/mingyu
Codex:
mkdir -p ~/.codex/skills
git clone https://github.com/gaowei90098-creator/mingyu-skill ~/.codex/skills/mingyu
Validation
python3 scripts/setup_env.py
python3 scripts/validate.py
Expected:
- Bazi helper returns valid JSON with four pillars and da-yun.
- Zi Wei helper returns valid JSON with 12 palaces and mutagens.
- Skill validation passes with the Codex skill validator.
Disclaimer
This project is for traditional culture study, entertainment, and AI product research. It does not provide medical, legal, investment, marriage, or other professional advice.
本项目用于传统文化学习、娱乐和 AI 产品研究。命理分析不构成医疗、法律、投资、婚姻等重大决策建议。
License
MIT