Capture
- 從專案根目錄執行:
git pull --rebase。 - 檢查範圍(AGENTS.md):是否明確發送?是否為排除的主題?移除任何機密資訊。
- 提取內容:
- 文字:直接使用,修飾措辭,保留原意。
- 連結:擷取頁面;記錄標題、作者、日期、3-7 個重點,以及在
source中放入網址。 - 語音:轉錄;保留擁有者的意圖;刪除填充詞。
- 長串討論串(X、論壇):閱讀完整的回覆文字,而非截斷的片段,且不限於第一頁。對於極長的討論串,應涵蓋實質主體(作者回覆、高訊號回覆)。在筆記中說明覆蓋範圍(例如「已閱讀 55 則作者回覆中的 40 則」)。
- 螢幕截圖/圖片:描述/OCR 相關文字;若有需要,將圖片儲存於
attachments/。
- 選擇知識庫(AGENTS.md 中的表格)。若不確定:預設知識庫
Inbox/加上一個問題給擁有者。 - 搜尋相同主題的現有筆記(
rg -il "<keywords>" vaults/<v>)。優先更新現有筆記(更新updated欄位),而非建立重複筆記。 - 若為新筆記:每個想法一個原子筆記;若輸入涵蓋多個想法則拆分。檔案名稱依 AGENTS.md 規範;前置資料包含
created/updated/source/tags;內容與標籤使用英文。 - 建立連結:至少一個
[[link]]連接到相關筆記或 MOC,並將其加入對應的 MOC(或Home.md)。未分類的筆記放入Inbox/。 - 絕不虛構;推測需標註。
- 提交前審查: 將草稿筆記與相關/已連結的筆記,以及知識庫的現有標籤(
rg -h '^tags:' vaults/<v> | tr -d '[]' | tr ',' '\n' | sed 's/^ *//' | sort -u)並列重讀。檢查並修正:- 內文與標籤使用英文。
- 標籤符合主題,並與相關/已連結的筆記一致。
- 優先重用現有標籤,而非發明新標籤。
- Wiki 連結以及 MOC /
Home.md的條目齊全。 - 沒有虛構的事實;推測已標註。
- 執行
python3 scripts/lint.py vaults/<v>;提交capture(<v>): <title>;立即推送。 - 簡短回覆所建立/更新的筆記。