游戏王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自动化了以下流程：
- 数据检索：通过获取原始卡元数据
ygo-db-cli. - 结构解析：识别起动机、延长器和发动机部件。
- 游戏分析：评估甲板指标（一致性、天花板等）。
- 报告：生成格式化
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的商标。本项目不隶属于科乐美数字娱乐，也不认可、赞助或特别批准。*