AI导哈

游戏王卡组分析工具

一个利用AI技术分析游戏王卡组的工具套件，提供卡组解析、概率计算和游戏表现评估功能。

  • by elmhuangyu
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 elmhuangyu/yu-gi-oh-mcp

使用说明

游戏王AI工具

英语 | 简体中文

一个专门用于分析Yu-Gi-Oh！使用AI代理技能的甲板。

概述

该项目提供了一套工具和代理技能，帮助人工智能助手（如Gemini CLI或Claude Code）理解和分析Yu-Gi-Oh！甲板人员。它使解析过程自动化 .ydk 文件、计算概率和生成专业级游戏评估。

项目结构

yu-gi-oh-ai-tools/
├── skills/                    # Agent Skills for Gemini CLI / Claude Code
│   ├── ygo-deck-analyze/      # Main orchestration logic
│   ├── deck-parser/           # Card classification & probability engine
│   ├── deck-analyzer/         # Gameplay & board-breaking analysis
│   ├── starter-probability/   # Hypergeometric calculator
│   ├── count-deck/            # Deck size validator
│   └── simple-calculator/     # Utility math
│
├── ygo-db/                    # Go-based CLI card database
│   └── cmd/ygo-db-cli/        # High-performance card lookup
│
└── test-dir-zh-cn/            # Sample decks for testing

特性

核心分析技能

技能 描述
ygo甲板分析 入口点。协调从原始数据到最终报告的整个流程。
甲板解析器 提取发动机核心、起动机、延长器和手动陷阱。专注于事实数据提取。
甲板分析仪 评估甲板性能：组合多样性、端板强度、瓶颈和资源循环。

实用技能

技能 描述
起始概率 使用超几何分布来计算绘制特定卡片组合的几率。
计数甲板 从YDK文件中快速计算主甲板、附加甲板和侧甲板尺寸。
ygoprodeck获取元 从YGOPRODeck获取最新的元甲板列表。

数据库工具

  • ygo-db-cli：一个基于Go的快速CLI，用于通过ID、名称、原型或YDK文件查询本地卡数据库。

分析工作流

这 ygo-deck-analyze skill自动化了以下流程：

  1. 数据检索：通过获取原始卡元数据 ygo-db-cli.
  2. 结构解析：识别起动机、延长器和发动机部件。
  3. 游戏分析：评估甲板指标（一致性、天花板等）。
  4. 报告：生成格式化 report.md.

输出工件

每次分析运行都会产生：

  • deck_raw.csv：来自数据库的原始元数据。
  • deck_parsed.json：对卡片角色和引擎组件进行分类。
  • deck_analysis.json：定量指标和6维评分。
  • report.md：人类可读的摘要和战略建议。

六维评分

度量 焦点
一致性 张开手的可靠性/起动器密度。
天花板 不间断时的最大端板功率。
韧性 能够通过手部陷阱或干扰进行游戏。
第二名 破局潜力和复出能力。
研磨 资源递归和长期游戏可持续性。
多样性 多种组合路径和游戏风格。

快速开始

# Get raw data for a deck
ygo-db-cli get-cards-by-ydk -i deck.ydk -o deck_raw.csv

# Run analysis via Gemini CLI / Claude Code
# Use the 'ygo-deck-analyze' skill on the generated CSV

需求

  • AI技能：Gemini CLI、Claude Code或兼容的AI代理环境。
  • ygo db：转到1.21+
  • python：3.14+（用于实用程序脚本）

许可证

Apache 2.0

游戏王是Konami Digital Entertainment的商标。本项目不隶属于科乐美数字娱乐，也不认可、赞助或特别批准。

相关 MCP