AI知識庫

AI知識庫是一個以 MkDocs Material 建置的公開知識庫網站，用來整理 AI 工具、提詞工程、研究與寫作、教學應用、知識庫維護流程，以及公開發布規範。

本網站的目標不是堆放零散筆記，而是把可公開、可重複使用、可持續擴充的知識整理成清楚的文章。所有進入 docs/ 的內容都應視為可能被公開發布。

目前目的

• 建立 AI 工具與工作流程的共同參考入口。
• 保存可重複使用的 Codex 與 AntiGravity IDE 維護流程。
• 建立提詞模板，減少每次重新描述任務的成本。
• 提供研究、寫作、教學與發布前檢查的通用流程。
• 讓未來新增內容時有一致的分類、格式與保密標準。

主要分類

分類	用途
開始使用	說明如何閱讀、搜尋與新增文章。
AI 工具	整理 Codex、AntiGravity IDE 與工具選擇方式。
提詞工程	提供提詞原則、Codex 任務模板與修訂模板。
工作流程	整理知識庫更新、發布前審核與 AI 維護流程。
研究與寫作	整理學術寫作、翻譯潤飾與引用檢查流程。
學術論文	提供 JRDRIVE/學術論文 的公開分類入口。
教學應用	整理課程規劃、作業設計與課堂討論模板。
維護規範	說明內容分級、發布檢查與 AI 使用政策。
參考資料	放置術語表、常用指令與檔案結構說明。

新使用者如何開始

1. 先閱讀如何使用本知識庫。
2. 需要找特定概念時，使用網站搜尋。
3. 不知道文章放在哪裡時，先看檔案結構。
4. 要新增文章時，使用 docs/TEMPLATE.md 作為格式。
5. 發布前依照發布前檢查清單逐項確認。

維護者如何新增內容

1. 判斷內容是否可公開。
2. 選擇最接近的分類資料夾。
3. 使用 docs/TEMPLATE.md 建立文章。
4. 將文章加入 mkdocs.yml 的 nav。
5. 執行：

mkdocs build --strict

1. 確認建置成功後再部署。

Codex 與 AntiGravity IDE 的角色

Codex 與 AntiGravity IDE 可協助：

• 依照模板建立新文章。
• 將零散筆記整理成公開知識庫文章。
• 檢查 mkdocs.yml 導覽。
• 執行或提醒執行 build。
• 檢查是否疑似包含不應公開內容。

但 AI agent 不應自行判定敏感資料可以公開。凡涉及私人資料、未公開研究、審稿資料、學生資料、帳號資訊或 credentials，應停止發布並請使用者確認。

發布前保密提醒

請不要把以下資料放入 docs/ 或任何公開頁面：

• API keys、tokens、passwords、private keys
• 個人資料、學生資料、受訪者資料
• 未公開研究資料、投稿內容、審稿資料
• 內部行政資料、私人信件、帳號資訊
• 未確認可公開的草稿或內部工作流程

詳細規則請見內容分級與發布規則。

常用指令

安裝套件：

pip install -r requirements.txt

本機預覽：

mkdocs serve

嚴格建置檢查：

mkdocs build --strict

部署到 Cloudflare Pages：

wrangler pages deploy site --project-name ai-knowledge-base

更新紀錄

• 2026-07-02：建立第一批知識庫內容與維護流程入口。