card-structure-validator
檢驗日文學習卡片的結構完整性和格式正確性。使用時機：- 當需要檢查卡片的 YAML frontmatter 格式- 當需要驗證卡片區塊（解釋、例句、相關連結）是否完整- 當卡片顯示異常需要診斷- 當批次建立完成後想抽查品質關鍵字：檢查卡片、驗證結構、卡片格式、YAML 錯誤、卡片診斷
When & Why to Use This Skill
The card-structure-validator is a specialized Claude skill designed to ensure the structural integrity and formatting accuracy of Japanese language learning cards. It automates the verification of YAML frontmatter, essential content blocks (explanations, examples), and internal linking, providing detailed diagnostic reports and actionable fix suggestions to maintain a high-quality, consistent digital study database.
Use Cases
- Validating YAML frontmatter metadata such as card_id, JLPT levels, and tags to ensure consistency across a large Japanese vocabulary deck.
- Ensuring all mandatory sections, including Japanese, Chinese, and English explanations, are present and correctly formatted in newly created study cards.
- Diagnosing formatting errors or broken relative Markdown links within a Zettelkasten-style knowledge base to prevent display issues.
- Performing quality assurance spot checks after batch-generating learning materials with other AI agents to verify structural compliance.
| name | card-structure-validator |
|---|---|
| description | | |
卡片結構驗證
檢驗日文學習卡片的結構完整性，提供診斷報告和修復建議。
使用方式
讀取指定卡片，執行結構檢查，輸出診斷報告。
請檢查 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腳本