更新 Wiki 技能
重新整理 wiki 頁面中手寫的散文章節,以反映當前的程式碼庫狀態。由編排器管理的產生式指標/資料區塊絕不可觸碰。
何時啟用
- 使用者輸入
/update-wiki— 更新所有包含散文的頁面 - 使用者輸入
/update-wiki Architecture— 僅更新wiki/Architecture.md - 使用者說「重新整理 wiki 散文」、「更新入門敘述」、「改寫架構文件」
- 在進行重大重構並改變系統設計敘述之後
此技能的步驟
-
確定範圍。 如果提供了頁面名稱引數(例如
Architecture),則解析為wiki/{PageName}.md。否則,排程下方列出的所有包含散文的頁面。 -
針對每個目標頁面: a. 讀取 wiki 頁面檔案。 b. 找出每個
<!-- claude:prose -->...<!-- claude:prose:end -->區塊。 c. 讀取下方頁面登錄檔中列出的相關原始碼檔案,以建立上下文。 d. 改寫標記之間的內容,使其準確反映當前的程式碼庫 — 保留相同的整體結構(標題、段落順序),除非在事實上錯誤。 e. 將更新後的內容寫回檔案,並精確保留標記。 -
絕不觸碰產生的區塊。
<!-- generated:start -->...<!-- generated:end -->內的所有內容必須逐位元組保持相同。這些區塊由 wiki 編排器腳本維護。 -
架構決策記錄完全由 Claude 擁有。
wiki/Architecture-Decision-Log.md沒有generated區塊,也沒有claude:prose標記。Claude 維護整個檔案。更新時,請針對自上次記錄條目以來所做的任何架構決策,追加新的 ADL 條目。請勿修改現有條目。 -
提交提示。 所有頁面更新完成後,提醒使用者:
「Wiki 散文已更新。請執行
/commit以儲存變更,然後推送到 wiki 遠端。」
包含散文的頁面及其原始碼檔案
wiki/Architecture.md
散文區塊用途: 系統設計敘述 — 說明模組職責、資料流程,以及靜態網站和 Lambda 聊天代理如何組合在一起。
要讀取的相關原始碼檔案:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(用於頁面結構上下文)projects.html(用於頁面結構上下文)
wiki/Lambda-Chat-Agent.md
散文區塊用途: 代理設計原理 — 說明 Lambda 架構、知識庫載入、提示建構和回應處理。
要讀取的相關原始碼檔案:
lambda/lambda_function.pylambda/context/(所有.md檔案,如果存在)
wiki/Contributing.md
散文區塊用途: 入門敘述 — 為新貢獻者說明開發工作流程、測試理念和專案慣例。
要讀取的相關原始碼檔案:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
特殊處理: 沒有 claude:prose 標記。Claude 擁有整個檔案。追加新的 ADL 條目;絕不修改現有條目。
要讀取的相關原始碼檔案:
- 檢視近期的 git 紀錄,尋找重大的架構變更
CLAUDE.md了解目前工具決策lambda/lambda_function.py了解後端決策
標記保留規則
<!-- claude:prose -->
[Claude 改寫此內容]
<!-- claude:prose:end -->
<!-- generated:start -->
[絕不觸碰 — 編排器管理的資料]
<!-- generated:end -->
- 開頭和結尾標記必須各自獨立一行,且不得變更。
- 請勿在標記內緊鄰處插入額外的空白行。
- 請勿嵌套標記。
警告
絕不修改 <!-- generated:start --> ... <!-- generated:end --> 區塊。
這些區塊包含由 wiki 編排器產生的自動化指標和表格。修改它們將導致下一次編排器執行時產生合併衝突,或靜默覆寫您的變更。