AgentSkillsCN

card-structure-validator

檢驗日文學習卡片的結構完整性和格式正確性。 使用時機: - 當需要檢查卡片的 YAML frontmatter 格式 - 當需要驗證卡片區塊(解釋、例句、相關連結)是否完整 - 當卡片顯示異常需要診斷 - 當批次建立完成後想抽查品質 關鍵字:檢查卡片、驗證結構、卡片格式、YAML 錯誤、卡片診斷

中文原作
SKILL.md
--- frontmatter
name: card-structure-validator
description: |
  檢驗日文學習卡片的結構完整性和格式正確性。
  使用時機:
  - 當需要檢查卡片的 YAML frontmatter 格式
  - 當需要驗證卡片區塊(解釋、例句、相關連結)是否完整
  - 當卡片顯示異常需要診斷
  - 當批次建立完成後想抽查品質
  關鍵字:檢查卡片、驗證結構、卡片格式、YAML 錯誤、卡片診斷

卡片結構驗證

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

使用方式

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

code
請檢查 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]]

輸出格式

markdown
## 卡片結構診斷報告

**檔案**:{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 腳本