進化事件
記錄一次嘗試為什麼開始、採用了什麼方法,以及最終發生了什麼。
EvolutionEvent 是過程記錄,用來解釋一次進化嘗試。它可以幫助定位成功、失敗或沒有有效改動的原因,不應只保留成功案例。
從事件裏尋找什麼
- 起因:錯誤、測試失敗、優化目標或其他輸入信號。
- 選擇:使用了哪些策略或已有經驗,為什麼適合當前任務。
- 過程:關鍵操作、相關產物和驗證步驟。
- 結果:實際成功、失敗或無有效變化的證據。
- 關聯:對應任務、Gene、Capsule 與驗證報告。
以上是閲讀線索,不代表每個版本都顯示相同的界面字段。
示例:追蹤兩次修復嘗試
| 階段 | 記錄重點 | 能回答的問題 |
|---|---|---|
| 發現錯誤 | 依賴升級後構建失敗,保留環境與首個錯誤 | 為什麼啓動這次嘗試? |
| 第一次處理 | 嘗試修改配置,但相同錯誤仍出現 | 什麼方法沒有奏效? |
| 第二次處理 | 核對兼容條件後完成最小修復 | 為什麼換了方向? |
| 驗證結果 | 構建與受影響功能檢查的真實結果 | 是否足以支持成功結論? |
| 整理經驗 | 關聯策略與經過驗證的執行證據 | 下次可以複用什麼? |
這是一段教學示例,不是實際運行日誌。事件應保留真實發生的順序,不能事後刪除失敗步驟,讓過程看起來一次成功。
排查一次異常
- 從當前任務或產物定位相關記錄,確認時間和運行環境。
- 找到第一個偏離預期的環節,不只看最終錯誤。
- 對照策略、輸入和權限,區分工具失敗、環境問題與方法不適用。
- 檢查是否執行了驗證,以及結論是否與輸出一致。
- 若重新嘗試,保留與原事件的關聯和新的驗證結果。
與日誌和膠囊的區別
原始日誌保留詳細執行輸出;事件側重能解釋決策和結果的過程信號。膠囊則側重某次經過驗證的執行結果及複用所需證據。
因此,不要把整個終端輸出直接當作成功膠囊,也不要只寫一句摘要就丟失必要的過程依據。
保存與審閲
通過 GEP 資產配置定位本地事件記錄,具體位置參見資產路徑。查看時以只讀檢查為主,不手工刪除失敗事件來修正統計。
分享前去除秘密和私有內容。恢復或遷移時,除了文件能讀取,還要核對事件與策略、結果之間的引用關係。