在昨天我們聚焦於 新成員 onboarding，今天的重點是 定期清理與重構 System Prompt，確保長期維護的可持續性，避免技術債務累積。

一、為什麼要清理與重構 System Prompt

隨著團隊規模擴大與專案累積，System Prompt 可能出現以下問題：

1. 過時規範
   曾經的最佳實踐可能因工具更新或專案變動而不再適用。

2. 冗餘模組
   基礎規範、專案特化規範或測試範例可能存在重複或衝突。

3. 規則表述不清
   初期編寫的約束條件或上下文描述可能過於模糊，AI 理解效果下降。

4. 維護成本高
   不清楚哪些模組仍被使用，修改時容易破壞現有流程。

如果不定期清理，規範會變成「積灰文件」，不但降低新人成長效率，也會增加技術債務。

二、識別過時或無效規範的方法

重點是 將清理與重構融入日常開發流程：

• 常態性審查：每次 AI 模型更新、系統工具升級或專案結束時，團隊一起回顧規範。

• 專案切換時檢查：新專案開始或現有專案技術棧調整時，檢視現有規範是否仍適用。

• 定期回顧：每季度或半年召開一次規範討論會，決定哪些規則需要調整或淘汰。

評估維度：

三、System Prompt 清理與重構流程

重構不需要一次完成，而是 融入日常開發節奏：

1. 常態性檢查與分類

• 在日常開發中，觀察哪些規則經常使用、哪些被忽略。

• 模組化規範可分為：

  • 基礎規範：所有專案通用。
  • 專案特化規範：僅在特定專案中使用。

• 將長期未使用或過時的規則，移到 /archive，保留歷史紀錄。

2. 重構與整合

• 將冗餘或重複的規則合併，形成單一維護點。

• 對命名、測試、錯誤處理等核心章節統一表述。

• 確保每個模組都清楚標明用途與適用範圍，方便團隊快速理解。

3. 驗證與迭代

• 在模型升級或規範修改後，使用 AI 生成小範例程式碼，比對是否符合新規範。

• 針對不符合規範的情況，更新說明文件或調整規則表述。

四、規範簡化與效率提升

• 減少冗餘文字：將長篇約束條件拆分為短規則，便於 AI 理解。

• 模組化載入：僅在需要時引入特化規範，減少 Context 負擔。

• 優先級明確：基礎規範優先，專案特化規範覆蓋，確保規則衝突可控。

五、建立維護與重構的文化

1. 與模型升級同步
   每次更換 AI 模型版本，檢查規範是否仍適用，必要時進行調整。

2. 與專案迭代同步
   專案技術棧調整或完成後，順便檢視規範，淘汰無效模組。

3. 定期討論
   每季度或半年召開一次規範回顧會，收集使用者與新人成長反饋。

六、結語

System Prompt 的清理與重構，不是一次性任務，而是 日常維護的一部分。

核心思路：

• 融入日常開發與專案管理節奏。

• 將過時規則移至 archive，保留歷史紀錄。

• 在模型更新或專案變動時進行重整，確保規範始終有效。

• 透過模組化與簡化，提高維護效率與 AI 理解精準度。

這種「隨時檢視、常態更新」的方式，能讓團隊保持規範的一致性，同時降低技術債務。