troubleshooting-docs

troubleshooting-docs 技能是 Plugin Freedom System 的自動化組織記憶引擎。它專為在 JUCE 框架內工作的軟體開發人員和音訊工程師所設計，旨在於解決問題後立即擷取除錯洞察。透過監控如「it's fixed」或「/doc-fix」等對話觸發詞，該技能會自動提取技術背景（例如症狀描述、根本原因、作業系統版本及特定程式碼調整），並將其組織成可搜尋的 Markdown 知識庫。這能確保每個已解決的問題都能成為未來開發週期的可重複利用範本，消除編譯失敗、GUI 當機或 DSP 演算法錯誤的遺忘曲線。

• 自動擷取並清理問題症狀、根本原因與技術解決方案，以便快速檢索。

• 強制執行嚴格的 YAML 前言架構，確保文件一致性與基於枚舉的分類。

• 執行基於 grep 的現有文件自動搜尋，防止重複條目並建議相關參照。

• 與模式偵測系統整合，識別重複發生的關鍵問題，從而推動架構的主動改進。

• 支援編譯失敗、API 誤用、階段性實作錯誤及執行期診斷的系統化記錄。

• 問題驗證後，可使用自然語言確認或 /doc-fix 指令觸發文件記錄流程。

• 輸入要求包括精確的錯誤日誌、JUCE 版本、特定的外掛階段及可操作的修復步驟。

• 系統會在儲存至分類目錄的 Markdown 檔案前，針對預定義的枚舉架構進行所有文件驗證。

• 若偵測到類似問題，系統會提示使用者進行雙向參照，以加強組織知識網絡。

• 此工具僅限於已解決且經驗證的問題；它會跳過如簡單語法錯誤等瑣碎修復，以維持高品質、專業的知識庫。