archive

archive skill 概覽

archive skill 的功能是什麼

archive skill 是一套專注於 OrbitOS 風格 vault 的文件歸檔流程。它的工作很單純：找出已完成的專案與已處理過的收件匣筆記，確認哪些內容可以安全移動，再將它們歸檔到帶日期的資料夾中，同時保留可追溯性。如果你想讓目前的作用中資料夾更乾淨，但又需要可靠的歷史紀錄，這個 archive skill 就是為這類維護工作而設計。

誰適合安裝 archive

如果你的工作區使用結構化 markdown 筆記、frontmatter 狀態欄位例如 status: done 或 status: processed，以及固定的資料夾慣例，例如 20_Project/、00_Inbox/ 和 99_System/Archives/，就很適合安裝 archive。它適合已經有既定歸檔規範、想把封存流程做成可重複執行的人，不適合把它當成通用型知識管理助理來用的使用者。

為什麼使用者會選擇這個 archive skill

archive 的主要差異不只是「把舊檔案移走」。它會先辨識可歸檔的候選項目，把專案和收件匣項目分開處理，要求你確認範圍，再依年份或月份歸入 archive 路徑。和一般泛用提示相比，這種做法更可靠，特別是在你希望代理保留既有結構、並產出變更摘要時。

如何使用 archive skill

安裝前提與預期的 vault 結構

這個 archive install 最適合視為 repository 或 vault skill，而不是獨立應用程式。從原始內容可看出，這套流程預期你的結構包含：

• 20_Project/ 放專案
• 00_Inbox/ 放收件匣項目
• 99_System/Archives/Projects/YYYY/
• 99_System/Archives/Inbox/YYYY/MM/

在使用 archive 之前，先確認你的筆記系統確實符合這種配置；若不一致，請在提示中明確改寫路徑。請優先閱讀 SKILL.md，因為完整邏輯都在這個檔案裡；沒有額外的 helper scripts 或參考檔案可用來補充說明隱藏行為。

archive 需要哪些輸入，效果才會好

如果你提供的是具體規則，而不是一句「幫我整理筆記」，archive skill 的效果會更好。較強的輸入包括：

• 你的 vault 根路徑
• frontmatter 是否使用 status: done 與 status: processed
• 已處理的 inbox 筆記是否也能透過 [[ProjectName]] 連結辨識
• 你是要封存所有候選項目，還是只處理其中一部分
• 代理是只預覽移動結果，還是直接執行

更好的提示可以像這樣：
「Use the archive skill on my vault. Scan 20_Project/ for notes with status: done and 00_Inbox/ for notes with status: processed or clear conversion links. Show candidates first, then archive only confirmed items into dated folders and provide a summary report.」

archive 的實際使用流程

一個好的 archive usage 流程通常是：

1. 先要求只做發現與列出候選項目。
2. 檢查候選清單。
3. 批准全部、只處理專案、只處理 inbox，或只處理指定項目。
4. 讓代理把檔案移到 archive 資料夾。
5. 要求提供最終報告，列出舊路徑、新路徑，以及任何邊界案例。

這種兩階段模式很重要，因為這個 skill 的設計本來就是先確認、再移動內容。這能降低仍在進行中的筆記被誤封存的機率，也讓結果更容易稽核。

repository 閱讀路徑與品質建議

對這份 archive 指南來說，最重要的檔案是 EN/.agents/skills/archive/SKILL.md。建議先讀「Identify Items to Archive」和「Archive Process」兩個段落，因為這裡揭露了實際的觸發條件與目標資料夾結構。

幾個能提高結果品質的建議：

• 在執行 archive 前先統一 frontmatter；status 欄位不一致會削弱偵測效果。
• 如果缺少完成日期，請先告訴代理應該使用哪個日期來源來決定按年份歸檔。
• 要求輸出「summary report + exceptions」，這樣你才能抓出壞掉的連結、缺漏日期，或專案資料夾與單一檔案混雜的情況。
• 如果你的 vault 不是採用 OrbitOS 命名，請直接在提示中寫出對應路徑。

archive skill 常見問題

archive 比一般歸檔提示更好嗎？

如果你的筆記本來就遵循穩定的系統，那答案是是。一般提示也許能建議你做歸檔，但 archive skill 提供的是更明確的決策流程：偵測候選項目、呈現選項、依內容類型移動、再按照日期整理 archive。這能減少猜測空間，也更適合反覆執行日常維護。

archive 適合新手嗎？

只有在你的 vault 已經有結構的前提下，archive 才算對新手友善。如果你的筆記沒有標記、狀態欄位不一致，或資料夾安排很隨意，這個 skill 的幫助就會有限，得先把輸入規格化才行。它不是能自動拯救混亂筆記庫的魔法清理工具。

什麼情況下不該使用 archive？

當項目仍在進行中、完成狀態不明確，或你的需求其實是跨 vault 遷移，而不是單純封存時，就不應該使用 archive for Document Filing。如果你的系統不是採用 markdown 檔案與 frontmatter 狀態欄位，這個 skill 也不太適合。

這份 archive 指南的主要邊界是什麼？

從 repository 內容可看出，核心只有一個主要檔案，沒有自動化腳本，因此這個 skill 的價值主要在於提示設計與流程紀律，而不是可直接執行的工具。你可以期待它提供清楚的歸檔邏輯，但不要預期它會內建深度驗證、自動修復連結，或客製化遷移程式碼；除非你把這些能力另外納入自己的 agent workflow。

如何改進 archive skill

給 archive 更清楚的判斷訊號

想提升 archive 結果，最快的方法就是把來源中繼資料整理得更明確。請使用一致的 status 值、補上完成日期，並在 inbox 筆記中明確標示專案連結。archive skill 就是依靠這些訊號，來區分哪些內容可以安全封存、哪些仍屬於進行中。

避免常見的 archive 失敗情境

最常見的問題是假陽性、缺少日期，以及專案資料夾和單一檔案在目標位置上的歸屬不明。要降低錯誤，可以要求代理：

• 在移動任何內容前先預覽候選項目
• 標示中繼資料不完整的筆記
• 把「可直接歸檔」和「需要人工複查」分開
• 在執行前先回報任何路徑衝突

為 archive usage 撰寫更強的提示

較弱的請求是「archive my vault」。更強的寫法則是：
「Run the archive skill in preview mode. Detect completed projects in 20_Project/ and processed inbox notes in 00_Inbox/. Use frontmatter first, then project links as a secondary signal. Show proposed destination paths under 99_System/Archives/, highlight uncertain items, and wait for approval before moving files.」

這種提示之所以更有效，是因為它明確定義了範圍、偵測順序、執行模式，以及回報預期。

在第一次 archive pass 後持續迭代

第一次執行後，請回頭檢查這個 skill 漏掉了哪些項目、又錯分了哪些內容。接著更新你的提示或 vault 規則：補齊缺少的狀態欄位、定義沒有日期的筆記該怎麼處理，並說清楚已轉換的 inbox 筆記是否應一律封存。當你的歸檔規則愈來愈明確、可以重複套用時，archive install 的價值也會隨時間提高。