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 learning cards. It automates the verification of YAML frontmatter, essential content blocks (explanations, examples), and Markdown link formats, providing actionable diagnostic reports to maintain a high-quality educational knowledge base.
Use Cases
- Validating YAML frontmatter fields such as card_id, JLPT level, and tags to ensure metadata consistency across a learning database.
- Performing quality assurance on newly created cards to verify the presence of mandatory sections like Japanese, Chinese, and English explanations.
- Diagnosing and troubleshooting display issues or broken Markdown links within a Zettelkasten-style Japanese study system.
- Conducting spot checks after batch processing to identify structural errors and receive specific repair suggestions for card optimization.
| 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腳本