ygo-deck-analyze

Files (1)

• SKILL.md

SKILL.md (first lines)

# ygo-deck-analyze

## 职责

这是整个分析流程的协调者（orchestrator）。

负责：
- 建立工作目录和进度追踪文件
- 按顺序执行四个步骤
- 每步完成后将产物 dump 成文件
- 如果某步失败，记录断点，下次可从断点恢复
- 生成最终人类可读报告

不负责：
- 卡片信息获取（由 deck-parser 处理）
- 对局分析判断（由 deck-analyzer 处理）

---

## 工作目录结构

每个卡组建立独立目录，命名规则为 `{ydk文件名}_analysis/`。

```
{deck_name}_analysis/
├── TODO.md              # 进度追踪，每步完成后更新
├── deck_raw.csv         # Step 1 产物：CLI 原始返回数据（CSV格式）
├── deck_parsed.json     # Step 2 产物：deck-parser 输出
├── deck_analysis.json   # Step 3 产物：deck-analyzer 输出
└── report.md            # Step 4 产物：最终人类可读报告
```

---

## 断点恢复逻辑

开始前，先检查工作目录是否已存在：

- 如果目录不存在 → 全新开始，执行 Step 1
- 如果目录存在，读取 `TODO.md` → 找到第一个未完成的步骤，从该步骤继续
- 如果某个产物文件存在且非空 → 该步骤视为已完成，跳过

---

## 执行流程

### Step 1 — 初始化工作目录

1. 根据 `.ydk` 文件名创建工作目录，并创建 `TODO.md`

```bash
mkdir -p {deck_name}_analysis && touch {deck_name}_analysis/TODO.md
```

2. 写 `TODO.md`，内容如下：

```markdown
# {deck_name} 分析进度

## 文件
- ydk: {ydk_filename}
- 开始时间: {timestamp}

## 步骤
- [ ] Step 1: 获取原始卡片数据 → deck_raw.csv
- [ ] Step 2: 解析卡组结构 → deck_parsed.json
- [ ] Step 3: 对局分析 → deck_analysis.json
- [ ] Step 4: 生成报告 → report.md
```

3. 在 `TODO.md` 中将 Step 1 标记为进行中。

---

### Step 2 — 获取原始卡片数据

使用 `ygo-db-cli` CLI 工具获取卡片信息：

```bash
ygo-db-cli get-cards-by-ydk -i {ydk文件路径} -o deck_raw.csv
```

CLI 工具会将数据（CSV格式）完整 dump 到 `deck_raw.csv`。

> 保存原始数据的目的：如果后续解析逻辑有问题，可以直接重跑解析步骤，不需要重新调用 CLI。

完成后更新 `TODO.md`：
```markdown
- [x] Step 1: 获取原始卡片数据 → deck_raw.csv
```

---

### Step 3 — 解析卡组结构

读取 `deck_raw.csv`，调用 `deck-parser` skill 进行卡组结构解析。

输入：`deck_raw.csv`
输出：按 `deck-parser` skill 定义的 JSON schema 生成结果，dump 到 `deck_parsed.json`。

完成后更新 `TODO.md`：
```markdown
- [x] Step 2: 解析卡组结构 → deck_parsed.json
```

---

### Step 4 — 对局分析

读取 `deck_raw.csv` 和 `deck_parsed.json`，调用 `deck-analyzer` skill 进行完整对局分析。

输入：`deck_raw.csv` + `deck_parsed.json`
输出：按 `deck-analyzer` skill 定义的 JSON schema 生成结果，dump 到 `deck_analysis.json`。

完成后更新 `TODO.md`：
```markdown
- [x] Step 3: 对局分析 → deck_analysis.json
```

From elmhuangyu/yu-gi-oh-ai-tools, Apache-2.0.

More from elmhuangyu/yu-gi-oh-ai-tools