卡片模板規範
本知識庫使用 5 種卡片模板，依內容性質選用。每張卡片必須遵守通用欄位規範，並依模板類型補上特定區塊。
通用 Frontmatter 欄位
✅ 必要欄位（5 項）
title: '卡片標題（中英文）'
tags: [divination, ...] # 至少含 divination + 派別/類型
created: 2026-04-17
stage: seed | growing | mature
confidence: high | medium | low⭕ 選填欄位（依情況加）
type: term | reference | formula | perspective | comparison
description: 一句話說明（SEO 用）
source: 紫微斗數職業班 第XX講
verification:
status: empirical | source-traced | internal-consistent | faithful-extraction | unverifiable
what_was_done: "具體做了什麼"
what_was_not_done: "沒做什麼，明說"
confidence_within_limits: high | medium | low
is_school_specific: true # 只在派別觀點卡標
flagged_for_review: true # 只在有矛盾時標5 級驗證狀態
| 圖示 | 狀態 | 意義 |
|---|---|---|
| 🟢 | empirical | 經驗可驗證（公式、數學） |
| 🔵 | source-traced | 可追溯權威來源 |
| 🟡 | internal-consistent | 體系內部一致 |
| ⚪ | faithful-extraction | 忠實呈現派別來源 |
| 🔴 | unverifiable | 本質上無法驗證 |
詳細說明 → 不可證偽領域的知識方法論
重要規則
- 不寫假 ✅：沒實際驗證就寫
what_was_done: "未實際比對"或留空 - 明說沒做什麼：
what_was_not_done是必要欄位，不要省略 - 信心限定範圍：
confidence_within_limits是「在可驗證範圍內」的信心，不主張形上學真假
Stage 與 Confidence 的差別
| 維度 | 意義 | 等級 |
|---|---|---|
| stage | 我對這個概念的「理解深度」 | 🌱seed → 🌿growing → 🌳mature |
| confidence | 卡片內容的「可信度」 | ⭐low → ⭐⭐medium → ⭐⭐⭐high |
舉例：
- 一個共識性術語可以是
seed + high（剛聽到但定義無爭議） - 一個觀點可以是
mature + medium（深入理解但仍是派別觀點）
📘 Template A：術語卡（term）
適用內容
單一概念的定義型卡片：五術、命理、共盤、同度等。
必要區塊
## 定義— 一段話講清楚是什麼## References— 至少一個來源
選填區塊
## 在系統中的位置— 例如「屬於 X 的子類」## 相關概念— wikilink 到其他卡## 💭 Think About This— 使用者填
範例
📊 Template B：對照表卡（reference）
適用內容
系統性對應關係：天干×五行、地支×生肖、四化×天干等。
必要區塊
## 對照表— 完整表格（不省略任何項目）## 使用情境— 什麼時候用到
選填區塊
## 記憶口訣— 只在有口訣時放## 應用範例— 1-2 個範例## 相關概念
範例
→ 天干與五行對照
🧮 Template C：公式卡（formula）
適用內容
可計算的方法：求年干、求年支、五虎遁、五鼠遁等。
必要區塊
## 公式— 公式本身## 步驟— 條列式操作步驟## 範例— 至少一個完整計算範例## 驗證狀態— 用萬年曆 / 獨立來源驗證的結果
選填區塊
## 對照表— 公式需要的查找表## 邊界條件— 特殊情況、異常值## 替代方法— 其他算法
特殊處理：有矛盾時
若公式驗證失敗，完整保留錯誤版本，加上：
flagged_for_review: true## ⚠️ 驗證警告區塊放在最上方## 處理待辦區塊列出修正步驟
範例
💭 Template D：觀點卡（perspective）
適用內容
派別主張、教學方法、對傳統的批評。
必要區塊
## ⚠️ 立場聲明— 註明這是派別觀點## 派別歸屬— 來自哪派## 主張— 觀點本身
選填區塊
## 為什麼這樣主張— 推理依據## 對立觀點— 其他派別怎麼看## 💭 Think About This— 使用者填
Frontmatter 必要
is_school_specific: truetags須包含派別名稱（如zhongzhou）
範例
🔀 Template E：派別對比卡（comparison）
適用內容
同一概念在不同派別的解讀差異：如田宅宮、四化、共盤解法等。
必要區塊
## ⚠️ 立場聲明— 不替讀者選邊## 共識（各派接受）— 跨派同意的部分## 派別觀點對比— 至少 2 派## 為什麼有爭議— 歷史/社會背景成因
選填區塊
## 💭 Think About This— 使用者判斷哪派更有說服力## 相關概念
範例
命名規則
檔案命名
- 全小寫，連字符分隔：
wushu-five-arts.md、year-gan-formula.md - 派別對比類加
-comparison或-interpretation：tianzhai-interpretation.md - 警告類加
-flagged或在 title 標 ⚠️
目錄歸屬
| 內容性質 | 目錄 |
|---|---|
| 跨派共識（術語、公式、對照表） | shared/ |
| 紫微內部共識 | ziwei/consensus/ |
| 中州派觀點 | ziwei/zhongzhou/ |
| 派別對比 | ziwei/comparisons/ |
| 個人實踐 | applied/ |
修訂紀錄
- 2026-04-17：初版。從 5 張示範卡的實作經驗提煉。
- 2026-04-18：引入 5 級驗證框架，verification 欄位改用
status / what_was_done / what_was_not_done / confidence_within_limits的具體格式，取代模糊的 ✅/⏳/❌。