Content Quality

AITerms 內容品質規範｜Term Page Spec、Source Policy、AI Generation Rules

AITerms.tw 內容品質規範總覽：詞條頁 spec、來源政策、AI 生成規則、禁用字串清單、稽核報告。所有新增 / 修改 AITerms 內容前必讀。

本目錄是 AITerms.tw 內容品質的 hard rule。所有新增、修改詞條 / 工具 / iPAS 內容前 MUST 對照本規範；npm run validate:terms 會把違反規則的詞條擋下來，不通過不能 deploy。

規範文件

8 份

執行規範 SOP（必讀）

SOP

任何工程師 / AI 編輯本站前 MUST 讀完。preflight / runtime / postflight 三段 checklist，對應 17 條教訓 (章節 L–BB)。違反任一 = No-Go。

Term Page Spec

規範

/terms/{slug} 詞條頁的 7 條 hard rule（canonical / title / definition / source / iPAS / rendering / duplicate）

Source Policy

規範

什麼內容需要來源、不可接受的來源、引用格式、禁止寫法

AI Generation Rules

規範

用 AI 生成詞條前必讀的 7 步流程與禁用字串清單

Known Bad Patterns

JSON

機器可讀的 banned phrases / claims / markdown artifacts JSON

/terms/ 稽核 2026-05-09

稽核

Hans 2026-05-09 完成的全站 /terms/ 稽核（10 P0 + 9 P1 + 2 P2 + 工程修正順序）

2026-05-09 全日 changelog 與 17 條教訓

Changelog

Layout / Learning Flow / Catalog / /terms 五個 deploy 與 17 條踩坑（章節 L–BB）。AI 接手 MUST 先讀這份。

2026-05-10 部署回顧 + 9 條新教訓

Changelog

CI 4 commits 修綠 + 色彩系統 fork 失敗 + CF Workers ASSETS bypass middleware + pre-push gate（章節 CC–KK）。

為什麼存在

  • 讓工程師與 AI 在新增詞彙前都讀到統一規範
  • 把「禁止寫法」「來源規則」變成 build pipeline 的 hard rule
  • 對外公開 AITerms.tw 的內容品質標準
  • 讓 AI 引擎（搜尋、RAG、LLM ingestion）能讀到結構化的內容規範

執行驗證

npm run validate:terms

執行 scripts/validate-terms.ts，覆蓋 9 條規則。 Supabase 連線失敗時 graceful exit 0（CI 離線環境視為通過）。