card-structure-validator

Inspect the structural integrity and format correctness of Japanese learning cards. Usage occasions: - When you need to check the YAML frontmatter format of the card - When you need to verify the completeness of the card blocks (explanation, example sentences, related links) - When the card displays abnormally and needs diagnosis - When you want to sample check the quality after batch creation Keywords: Check cards, Verify structure, Card format, YAML errors, Card diagnosis

卡片結構驗證

檢驗日文學習卡片的結構完整性，提供診斷報告和修復建議。

使用方式

讀取指定卡片，執行結構檢查，輸出診斷報告。

請檢查 zettelkasten/verb-u/030_manabu.md 的卡片結構

檢查項目

YAML Frontmatter

| 欄位 | 必要性 | 驗證規則 | |------|--------|----------| | card_id | 必要 | 格式：{category}_{number} | | title | 必要 | 格式："日文 (讀音)" 或 "日文A vs 日文B" | | category | 必要 | 須為有效分類（noun, verb-u, grammar 等） | | jlpt_level | 必要 | n5, n4, n3, n2, n1 之一 | | tags | 建議 | 陣列格式 | | dictionary | 建議 | 包含 reading, pos, definition_ja |

必要區塊

| 區塊 | 驗證規則 | |------|----------| | 日文解釋 | ### 日文 或 ### 日文解釋 標題存在 | | 中文解釋 | ### 中文 或 ### 中文解釋 標題存在 | | 英文解釋 | ### English 標題存在 | | 例句 | ## 例句 區塊存在，且有編號例句 |

連結格式

| 檢查項 | 正確格式 | |--------|----------| | Markdown 連結 | [text](path.md) | | 相對路徑 | ../category/file.md | | 禁止格式 | [[wikilink]] |

輸出格式

## 卡片結構診斷報告

**檔案**：{path}
**card_id**：{id}

### ✅ 通過的檢查
- YAML frontmatter 格式正確
- 必要區塊完整
- 連結格式正確

### ⚠️ 警告
- 缺少 dictionary.definition_en（可選欄位）
- tags 數量較少（建議 3-5 個）

### ❌ 錯誤
- 缺少 English 解釋區塊
- card_id 格式不符（應為 verb-u_030）

### 修復建議
1. 新增 `### English` 區塊
2. 修正 card_id 為 `verb-u_030`

與 Agent 的關係

| 角色 | 職責 | |------|------| | card-structure-handler（Agent） | 批次建立卡片結構，並發執行 | | card-structure-validator（Skill） | 人工抽查驗證，互動式報告 |

互補而非替代：Agent 負責建立，Skill 負責驗證。

注意事項

此 Skill 只讀取和分析，不修改任何檔案
若需修復，請根據報告手動編輯或使用相關腳本
批次驗證請使用 verify-meta.py 腳本