基因
保存一種可複用的處理方法,而不是某一次任務的全部細節。
Gene 描述策略、觸發信號和適用邊界。Evolver 可以根據工作區中的信號召回相關 Gene,再結合當前任務判斷是否適合採用。
什麼值得保存為基因
適合提煉的做法應有明確的問題類型、可解釋的步驟和驗證方法。例如,重複出現的依賴兼容問題,可以總結排查順序;一次偶然成功的改動則還不足以證明方法可複用。
| 內容 | 應回答的問題 |
|---|---|
| 觸發信號 | 遇到什麼現象時考慮使用? |
| 前提與邊界 | 適用於哪些環境,哪些情況應停止? |
| 策略步驟 | 先檢查什麼,再處理什麼? |
| 驗證方式 | 如何判斷問題解決且沒有退步? |
| 失敗處理 | 無效時保留什麼證據,如何恢復? |
這是一份內容檢查表,不是可直接導入的 JSON schema。
示例:依賴升級後構建失敗
觸發信號:升級依賴後出現原先沒有的構建錯誤。
策略:保留首個錯誤和版本信息,核對依賴兼容要求,定位最小差異,只修改與錯誤相關的配置或代碼。
驗證:在相同環境中重新構建,並運行受影響功能的檢查。
不適用情況:如果失敗來自缺少憑證或服務不可達,先處理運行環境,不通過降級依賴掩蓋問題。
這裏保留的是排查方法。某個項目實際修改了哪個文件、測試輸出是什麼,應由膠囊及過程記錄説明。
複用前檢查
- 比較錯誤信號是否相似,不只匹配標題中的關鍵詞。
- 檢查運行環境、依賴版本和權限前提。
- 將策略映射到當前項目,明確允許修改的範圍。
- 執行後驗證,記錄本次結果與原經驗的差異。
召回或選中 Gene 不等於授權執行其中所有步驟。涉及刪除、網絡訪問或發佈時,仍遵循當前任務的權限。
更新與失效
同一策略在新環境中失敗時,先查清原因。環境變更、步驟過期和驗證缺失應分別記錄,不能直接把失敗結果改寫成成功。
保留來源和版本關係,避免覆蓋後無法解釋舊結果。涉及外部資產的審核、撤銷和升級,參見資產治理。
保存與共享
本地 GEP 資產位置取決於運行配置,參見資產路徑。不要直接覆蓋運行中的資產文件。
需要結構化蒸餾時,使用對應版本支持的工具;具體命令與質量要求見蒸餾 Gene、Skill 與 Recipe。發佈前還應檢查隱私、引用和驗證證據。