simonpokorny/knowledgebase

將一個小型、綱要簡潔的條目寫入儲存庫的 .knowledgebase/。如果儲存庫沒有 .knowledgebase/，請停止操作並告知使用者應先執行 /setup-knowledgebase 技能。

1. 選擇類型：

   這是	類型	路徑
   關於系統的真實斷言，值得記錄而非重新發現	finding	.knowledgebase/entries/finding-<主題-kebab>.md
   行為規則，通常源自錯誤	learning	.knowledgebase/entries/learning-<主題-kebab>.md
   在替代方案中的選擇，帶有權衡	decision	.knowledgebase/entries/decision-NNNN-<主題-kebab>.md

2. 撰寫條目。Frontmatter 欄位、狀態、限制與主體慣例均記載於 ENTRY-FORMAT.md；請在撰寫前閱讀該文件。此外掛的 templates/ 目錄中附有實際範例。

3. 檢查狀態是否如實反映。對於 findings 和 learnings：僅當你在當前工作階段親自證明了該斷言時，才使用 verified，並設定 verified-by: agent，同時在正文中提供證據（來源連結或你所執行的檢查）。任何你無法證明的內容應保持 unverified；這些條目需要人類在審查時進行驗證。新的 decisions 的狀態為 decided，並分為兩類：

   • 實作決策（Implementation decisions）：你在建構過程中所做的基本選擇。記錄其原因與權衡，並標示為 decided-by: agent。
   • 規劃決策（Planning decisions）：與使用者共同做出的決定，無法從程式碼推斷。也將其記錄為 decided-by: agent，然後在 session 結束的報告中向使用者提供採用行，以便該條目最終成為 decided-by: human。 絕對不要自行設定 decided-by: human；只有人類可以設定。這兩類決策日後都可能被更新的決策所 superseded（取代）。

4. 如果條目是一個禁止某個指令的 learning（學習），請加入 guard: 正規表示式，使規則能夠自我強制執行。Guard 的撰寫規則位於 ENTRY-FORMAT.md 中；在提交前請使用 grep -E 測試該正規表示式。

5. 將條目提交至與產生該變更相同的分支，使其與該提交保持同步。請勿將條目積累後再批次提交。