knowledge-cards

name	knowledge-cards
description	Standardizes the full lifecycle of atomic knowledge cards (Zettelkasten term cards) in a content collection: creation criteria, gap detection via the term-role × baseline matrix, card authoring format, registration points (index + tool scope), link backfill, and module-scale audits. Use when creating cards, auditing a module for missing cards, restructuring card directories, or wiring card links into articles. Triggers: 建卡, 知識卡, 缺卡, 術語卡, 卡片 audit, 卡片格式, 概念位置, 鄰卡連結, 回填連結, 卡片目錄, 卡片重構, 詞頻掃描, 基線, 行內解釋, knowledge card, term card, card gap.
license	MIT
metadata	{"version":"1.3.0","category":"content-methodology"}

Knowledge Cards（知識卡生命週期）

知識卡是內容體系的原子抽象層：一張卡承載一個術語的核心概念、讓文章用連結取代行內解釋、讓解釋只寫一次被全體引用。本 skill 標準化卡片的完整生命週期——從「這個詞該不該有卡」到「模組級的缺卡 audit」——讓建卡動作在任何模組、任何批次都走同一套判準。

---

生命週期六站

站	核心問題	關鍵判準
1 判準	這個術語該有卡嗎？	教學需求：目標讀者群裡最不熟悉的那端能不能理解；出現頻率只是輔助訊號
2 落點	卡住在哪個目錄？	概念的主要領域歸屬；一卡一住址、跨模組用連結不重複建卡
3 撰寫	卡片長什麼樣？	四段結構（定義 / 概念位置 / 訊號與例子 / 判讀方式）＋首段與概念位置段鄰卡連結
4 登記	卡片在哪些地方要現身？	collection index 分類表＋lint 工具的作用域清單——兩者都是必經註冊點
5 回填	文章怎麼接上卡？	每篇文章該術語第一次出現處連卡、後續裸用
6 Audit	存量模組的缺口在哪？	詞頻掃描 × 缺卡判定矩陣 → 優先序 → 批次建卡

缺卡判定矩陣（速查）

術語處理分三級：行內展開（正文 1-2 句定義）、連卡、裸用。判定用兩軸——術語在本文的角色（主線 / 支撐 / 背景）×是否在本文的前置知識基線內（基線＝模組讀者定位 ∪ 閱讀路線中前置篇章教過的主線術語）：

術語角色	基線外	基線內
主線	行內展開＋連卡	行內展開（本文就是在教它）
支撐	連卡（卡不存在 → 先建卡）	連卡（預設）或裸用
背景	連卡	可裸用

「支撐 × 基線外 × 無卡」就是缺卡的精確定義。文章越深、越多術語落入基線、行內解釋自然遞減；連卡密度不遞減——它是空降讀者（搜尋直達深度篇）的回路。

註冊點清單（漏一個都不報錯）

新卡片或新卡片目錄需要在數個彼此獨立的註冊點現身、漏掉任何一個都不產生錯誤訊號：

1. Collection index 分類表——目錄的索引頁要列出這張卡（實測發現過整批卡運作正常、文章連得到、只有索引層看不見它們）
2. Lint 工具的作用域清單——frontmatter 必填檢查跟卡片結構檢查（鄰卡連結 / orphan）通常是兩個獨立的目錄清單、都要登記。作用域外的目錄跑檢查會得到零 error——那是「沒被看」不是「沒問題」、檢查通過的假象比沒檢查更危險
3. 上層入口——新建卡片目錄時、模組首頁或站台首頁的對應分類段要同步
4. Weight 編號帶——新卡接續該目錄的既有編號帶、不隨手給不撞號的值

觸發路由

觸發情境	讀哪份 reference
要寫一張或一批新卡（判準、落點、格式、命名、批次紀律）	references/card-authoring.md
要對存量模組做缺卡 audit、規劃回填、或大規模重構卡片目錄	references/gap-audit-and-backfill.md

每份 reference 自包含、閱讀任一份不需要回來看另一份。

跟其他寫作流程的分工

本 skill 管卡片的生命週期（判準 / 落點 / 登記 / 回填 / audit）。卡片內文的字句層品質（正向陳述、中性 register、地區用語）屬單篇寫作方法的範疇——專案若有對應的寫作 skill、批次建卡後的字句層自審套用該 skill 的 keyword bank；批次多輪審查的 frame 規劃屬 review 流程 skill。三者疊加、互不取代。

---

Version: 1.3.0 — 從第一輪全站 audit（4 掃描 fork + 3 建卡代理 + 3 債務艦隊、19 張新卡、338→6 warning）回收判定補充規則：(1) 「無卡」比對範圍是全站所有卡片目錄含同義詞——實測擋下 4 張would-be重複卡；(2) 跨篇逐字重複定義是缺卡加強訊號、建卡後收斂重複句；(3) 「連長文」含同章段落式教學；(4) 模組索引 backlog 筆記是候選來源、以正文實際出現做最終判定；(5) L4 首段判定精確化（AST 第一段、遇空行即止）；(6) L2 孤兒的 _index.md 本文算有效來源、無真實出現走存廢清單且刪卡由維護者裁決 Version: 1.2.0 — gap-audit-and-backfill 補「規模化執行：代理人派工協議」段（從第一次全模組回填的多代理實測抽出）：prompt 給清單與底線、判準指向 skill；事實紀律顯式重申；回報必含完成度自證（實測主要失誤是代理靜默停止不回報）；驗收以 repo 狀態為準不以報告為準；多代理飛行中主線不提前 format / commit；每次派工同時回收 skill 完整性回饋 Version: 1.1.0 — 從第一次代理人執行（10 張卡批次、由較小模型代理依本 skill 自主完成）回收兩條：(1) card-authoring 補「批次完成後的機械自驗」script（首段 / 概念位置段鄰卡連結計數——實測一批 10 張有 1 張首稿漏連結、自讀沒抓到、機械統計立刻現形）；(2) 補「字句層命中是候選不是判決」段與兩類實測 false positive（字面意義的泛用詞 / 數學結構的真必然）、判別線是「必然有沒有上游設計選擇當前提」 Version: 1.0.0 — 初版：生命週期六站（判準 / 落點 / 撰寫 / 登記 / 回填 / audit）、缺卡判定矩陣（術語角色 × 基線）、註冊點清單（index / 工具作用域雙清單 / 上層入口 / weight 帶——含「作用域幻覺」教訓：檢查通過可能只是不在作用域）、兩份 reference（card-authoring / gap-audit-and-backfill）。從一次金融分析模組的缺卡 audit 與第一批 8 張卡的實跑經驗抽出