itwilldo-wiki-demo

上一篇把資料灌進去了，這篇繼續把剩下的功能都示範完。

今天要跑的功能有：

1. query：拿灌進去的資料問問題
2. archive：把做完的 project 封存
3. status：看現在改了什麼
4. lint：commit 前的健檢
5. commit：存檔
6. pull：換一台電腦，把進度拉下來

那就直接來

一、query：問問題

知識庫裡有一份「關於我」的筆記，裡面記了我的外觀特徵。我們來問一個需要讀過資料、並且用這些資料進行判斷的「模糊問題」。

那什麼問題那麼模糊呢？

/wiki-query 我想剃成光頭　我的臉型適合嗎

功能正常，回報會分三段：

• 相關主題：這次用到哪個主題
• 查詢紀錄：搜了什麼關鍵字、命中哪些檔案、讀了哪幾頁
• 答案

其中，答案又分成兩塊：「來源內容」跟「我的推論」。來源內容是知識庫裡真的寫了什麼，推論是 AI 根據這些內容判斷了什麼。

回頭看一下它引用資訊正不正確，有沒有掰資訊出來：

還可以

但是結論居然是不建議剃光頭，太令人失望了。

二、archive：封存 project

上一篇 promote 進來的 iThome鐵人賽2026 project 共五篇，這邊假設它結束了，要封存。

封存前的樣子，五篇在 projects/active/ 底下：

一句話批次處理：

/wiki-archive 把 iThome鐵人賽2026 這個專案封存

封存的規則已經寫在 skill 裡，收到明確要求會直接做。

它除了搬資料夾，還順手修了一個連結：寫作技巧裡的「過度發明名詞」有一條連到第五篇的完整路徑，搬家之後路徑變了，它改成新路徑。

在搬移檔案之外，還幫忙處理了正確性的問題，優秀。

（畫面裡有一行「Classifier 暫時無法判定」，是 auto mode 的權限判斷卡了，平常心處理，不影響結果。）

完成回報三件事：

• 搬移：用 git mv 把整個資料夾從 active/ 移到 archive/
• 修正連結：正確性問題
• 更新索引：index.md 裡的條目移到 Archived Projects

1-raw/ 裡的原檔沒動。

它最後建議直接跑 /wiki-commit，但我不要，我要先看一下 status。

三、status：現在改了什麼

• 跟遠端同步，沒有領先或落後
• 7 個異動：5 個搬移、2 個修改
• 1-raw/ 沒有變動

這就是剛剛 archive 做的事，一個不多、一個不少。

如果使用者有更酷炫的報告呈現方式可以直接手動改。

四、lint：commit 前的健檢

選單上寫著 lint「由 wiki-commit 呼叫」，這是我的設定。

原本 Karpathy 的 LLM Wiki 概念中，lint 是「定期」做。我這邊比起「定一個日期」，我選擇把 lint 綁在 commit 上：

• 可以減少每次需要檢查的內容
• 對於「語意檢查」來說，也會更有效率

想看詳細的 lint 規格與討論，可以往前翻第二十篇、第二十一篇。

四項檢查：

• 1-raw/ 不變性：略過，因為這次沒動到 1-raw/。略過也會講原因，不會默默跳過。
• 連結與索引結構：通過。剛剛搬了檔案，沒有留下斷掉的連結。
• Frontmatter：通過。
• index.md 內容：通過。它判斷專案的範圍說明本來就寫「系列完賽即結束」，封存後還是對的，不用改。

五、commit：存檔

/wiki-commit 會先跑一次 lint，通過之後列出：

• 範圍：這次要 commit 哪些檔案
• 訊息：草擬好的 commit message

確認之後才會真的 commit。 如果範圍裡混了不相關的檔案，這時候就可以擋下來。

commit 完成。最後一行：本地比遠端多 1 個 commit，還沒 push。

其實以「個人知識庫」這樣的使用場景，commit 跟 push 是可以直接綁在一起的，但是就我軟體開發的背景來說，commit、push 分開是有很明顯的好處，這部分就看使用者自己的取捨。

六、pull：換台電腦

推上去之後換一台電腦測試 /wiki-pull。

/wiki-pull 把剛剛 push 上去的封存拉下來：從 5476b35 前進到 5b650a4，一個新 commit、7 個檔案。

可以看到一個很明顯的「問題」：這次 AI 的回覆是英文。

這可能是因為我沒有在 CLAUDE.md 設定說要用中文回覆。這對我來說不是大問題，如果你覺得一定要看中文，就再自己把「要用中文回答」寫進 CLAUDE.md。

---

收尾

這篇把剩下的功能跑完了：

1. query：問問題，查詢出相關資訊後進行判斷並且回答
2. archive：封存 project，連結跟索引一起調整到正確
3. status：commit 前看一眼改了什麼
4. lint：健檢，跟 commit 綁在一起
5. commit：確認範圍之後才存檔
6. pull：多裝置同步遠端進度

加上上一篇的 ingest、promote，模板的八支 skill 已經全部跑過一次，運作正常。

下一篇是最後一篇，有其他問題再麻煩跟我說，感謝。