記憶
一個基於檔案系統的知識管理系統,其中源代碼本身就是記憶。將決策、模式和上下文儲存在結構化的 Markdown 檔案中。
使用時機
- 記錄架構決策
- 記錄開發過程中發現的模式
- 儲存關於為何以某種方式建置某物的上下文
- 追蹤已知問題和解決方法
- 儲存 API 文件或整合筆記
不應使用時機
- 臨時除錯筆記(請改用註解)
- 任務追蹤(請使用 Git Issue 或專案看板)
核心原則
- 源代碼是唯一的真理來源
- 將知識儲存在接近其使用位置的地方
- 使用結構化的 Markdown 以保持一致性
- 保持檔案聚焦(每個檔案一個主題)
儲存位置
| 類型 | 位置 | 範例 |
|---|---|---|
| 技術文件 | docs/technical/ | 架構決策、模式 |
| 功能文件 | docs/features/ | 功能規格、需求 |
| API 文件 | docs/api/ | API 合約、整合筆記 |
記憶操作
記住(寫入)
儲存新知識:
# [主題標題]
## 上下文
[為何存在,解決了什麼問題]
## 決策
[決定了什麼以及原因]
## 詳細資訊
[技術細節、程式碼範例]
## 參考資料
- [相關檔案或URL]
---
*建立日期:[日期]*
*最後更新:[日期]*
回憶(讀取)
擷取知識:
- 檢查
docs/目錄結構 - 讀取相關檔案
- 在文件中搜尋關鍵字
更新
修改現有知識:
- 讀取現有檔案
- 更新相關章節
- 若有重大變更,加入演化歷史
相關技能
| 技能 | 何時串連 |
|---|---|
| feature-dev | 在開發過程中儲存架構決策 |
| planning | 記錄計畫以供未來參考 |