檢驗日文學習卡片的結構完整性和格式正確性。 使用時機: - 當需要檢查卡片的 YAML frontmatter 格式 - 當需要驗證卡片區塊(解釋、例句、相關連結)是否完整 - 當卡片顯示異常需要診斷 - 當批次建立完成後想抽查品質 關鍵字:檢查卡片、驗證結構、卡片格式、YAML 錯誤、卡片診斷
檢驗日文學習卡片的結構完整性,提供診斷報告和修復建議。
讀取指定卡片,執行結構檢查,輸出診斷報告。
請檢查 zettelkasten/verb-u/030_manabu.md 的卡片結構
| 欄位 | 必要性 | 驗證規則 |
|---|---|---|
| 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`
| 角色 | 職責 |
|---|---|
| card-structure-handler(Agent) | 批次建立卡片結構,並發執行 |
| card-structure-validator(Skill) | 人工抽查驗證,互動式報告 |
互補而非替代:Agent 負責建立,Skill 負責驗證。
verify-meta.py 腳本