← 知識庫 / Knowledge base
EDITORIAL WORKSPACE
文章管理 / Articles
保存草稿 → 檢查內容 → 發布 → 更新搜尋索引。編輯已發布文章時,公開版本維持到下次發布。
需要管理者登入 / Administrator access required · 登入 / Sign in
請載入文章或建立草稿。
撰稿規範(給人與 AI) / Writing guide for humans and AI
每篇文章的讀者是之後要維護或仿作的人和 AI:讀完就能少走彎路,直接動手。不是開發日記、週報或發布清單。
給下一個撰稿的 AI:發文前照這份規範自我檢查;文章管理頁的「存入並發布」會用同一套規則檢查(src/scripts/work/writingGuide.ts 的 auditArticle),不符合就不發布。範例:〈不加依賴的 OpenTimestamps〉、〈把季報疊到日 K 線上而不偷看未來〉。
必須 / Must
- 一篇只講一個技術問題,標題寫成具體的問題或機制(例:「不加依賴的 OpenTimestamps」),不要寫「近期開發紀錄」。
- 只能是兩類之一,標籤第一個寫類別:Software Engineering(演算法、資料結構、資料庫、並行、協定、建置、測試)或 Quant Finance(一個指標或方法)。
- Software Engineering 段落依序:問題(輸入、輸出、限制、一個真實失敗案例)→ 原理(附一手來源)→ 實作(至少兩段真實程式碼,標路徑與 commit,寫不變式或複雜度)→ 替代方案(表格,至少兩個)→ 驗證(測試名稱、red→green)→ 限制 → 參考資料。
- Quant Finance 段落依序:問題(常見做法為何失真)→ 定義與公式(單位、頻率、公布時差)→ 用公開資料的逐步算例 → 實作對應(缺值、修正、時區、前視偏誤)→ 敏感度與反例 → 限制(不是投資建議)→ 參考資料。
- 加一段「踩過的坑」或檢查清單:別人最可能卡住的地方,以及怎麼避開。
- 數字、測試數、上線狀態都要能核對;計畫、程式完成、測試通過、正式上線分開寫。
不要 / Never
- 「決策一、決策二…」「最近幾天」「本週」「下一步」這類日記結構。
- 一篇拼多個主題;沒有程式碼或公式;「更穩定」「提升體驗」這類無法驗證的形容。
- 金鑰、帳戶資料、內網位址、私人報告。