convez.ai
Skill
gaowei90098-creator

mingyu-skill

gaowei90098-creator/mingyu-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude Code and Codex skill for Bazi and Zi Wei chart analysis

Instalação

$npx convez-ai gaowei90098-creator/mingyu-skill

1 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

Estrelas
3
Forks
2
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.1.0
Issues abertas
0
Contribuidores
1

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

ModuleWhat It DoesTypical 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

InputRequiredNotes
Solar birth dateYesYYYY-MM-DD preferred
Birth timeYes for full chartIf unknown, state uncertainty and avoid over-reading hour-sensitive parts
GenderYes for da-yun direction and Zi Wei conventionsSupports 男/女, male/female
BirthplaceRecommendedUseful when discussing true solar time
Existing chart JSONOptionalAgent can analyze already generated chart data

Analysis Guardrails

Mingyu Skill is designed to reduce common AI metaphysics mistakes:

RiskGuardrail
Mixing 八字大运 and 紫微大限Treat them as separate systems and label them clearly
Moving finished cycles into the futureLock full da-yun and decadal cycle sequence before interpretation
One-palace wealth judgmentRequire wealth analysis across 财帛、田宅、福德、官禄 plus 八字担财
Overconfident predictionUse tendency, evidence, and uncertainty instead of fatalistic claims
Missing dependencyContinue in pure Skill mode and disclose that deterministic scripts were not run
Health/legal/financial overreachKeep outputs as cultural and reflective guidance, not professional advice

Technical System

LayerChoice
Skill formatSKILL.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 helperPython 3.9+ with lunar-python
Zi Wei helperNode.js 18+ with iztro
Environment setuppython3 scripts/setup_env.py
Deterministic validationpython3 scripts/validate.py or npm test
Codex metadataagents/openai.yaml
LicenseMIT

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:

CaseExpected
Solar birth1995-08-15 14:30, male
Bazi pillars乙亥 甲申 戊寅 己未
Day master戊
Zi Wei Chinese date乙亥 甲申 戊寅 己未
Zi Wei palaces12 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

VersionDateHighlights
v1.1.02026-06-10Codex/Claude ready-to-copy skill directories, environment setup script, deterministic validation script, and accuracy documentation.
v1.0.02026-05-19First stable release. One-line installer, Claude Code/Codex support, Bazi helper, Zi Wei helper, domain references, Codex metadata.
v0.3.02026-05-19README polished for public GitHub usage, installation script added, repository topics configured.
v0.2.02026-05-19Compatibility pass: clear dependency model, npm test, friendly dependency errors.
v0.1.02026-05-19Initial 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

Ver o original no GitHub

Bom para

Relacionados