Evolver 技能
把反覆驗證的經驗整理成 Agent 能執行的工作説明。
技能適合表達一套有輸入、步驟、產物和檢查標準的工作流。它不是聊天摘要，也不是將 Gene 文件改名為 SKILL.md。Evolver 可以幫助提煉策略；將經驗組織成應用可用的技能，還需要明確工具、權限和運行前提。
什麼時候整理成技能
當相似任務多次出現，而且已經找到穩定做法時，技能能減少重複解釋。例如，團隊每週需要從記錄中整理進展，可以把資料範圍、輸出結構、缺失信息處理和驗收要求寫成工作説明。
如果做法只成功過一次，先保留結果與限制，再通過不同輸入驗證，不急於聲稱已經適合普遍複用。
一份技能應包含什麼
| 部分 | 週報工作流示例 |
|---|---|
| 觸發條件 | 需要從項目記錄整理週報 |
| 輸入 | 本週記錄、時間範圍、目標讀者 |
| 步驟 | 讀取材料、核對來源、分類整理、標記待確認問題 |
| 輸出 | 進展、阻塞和下一步，不編造缺失數據 |
| 驗證 | 每項結論有材料依據，日期與範圍一致 |
| 邊界 | 先生成草稿，發送或發佈另行確認 |
這是內容結構示例，不是安裝後的默認技能。
在 EvoX 中導入技能
整理並驗證技能後，通過技能頁的添加入口選擇來源。下方示意只改變示例狀態，不讀取目錄或安裝內容。掃描本機、ZIP 和 GitHub 導入的完整步驟見導入經驗。
導入
從 ZIP 文件或公共 ZIP 鏈接檢查並安裝技能。
將技能 ZIP 拖到這裏
也可以粘貼 ZIP 文件或公共鏈接。
一個壓縮包可以包含多個技能，最大 64 MB。
技能包與 .gepx 不是同一種格式；遷移進化歷史使用進化歸檔。
從經驗到可用工作流
以依賴升級為例：Gene 的策略是“先定位依賴變化，再用失敗測試縮小問題”；Capsule 記錄一次升級中受影響的版本、修復和通過的檢查。技能應提取穩定操作，而不是複製該次項目的全部路徑與日誌。
- 從多個相關結果中找出共同輸入：依賴清單、升級範圍、失敗測試與允許改動目錄。
- 寫成順序：讀取版本變化 → 復現失敗 → 最小修復 → 運行相關測試 → 彙報剩餘風險。
- 把版本號、項目名和個人路徑變成任務輸入；把外部服務不可用、無法復現等情況寫成停止條件。
- 用另一份升級任務試用，核對能否完成而無需複用舊項目的隱含上下文。
例如：“升級只涉及測試工具時，先跑其相關測試；無法復現時保留日誌，不修改無關業務邏輯。”這才是可複用指令。單次成功的 Capsule 仍作為證據保留，不因此自動變成通用技能。
Gene 表達方法，Capsule 保存結果，Skill 表達宿主可執行的工作説明，Recipe 串聯有序資產。命令與參數見蒸餾指南。
怎樣驗證這份技能真的能複用
為下一次依賴升級提供新的依賴範圍、失敗日誌與允許改動目錄，不攜帶上一次的完整聊天記錄。讓技能先復現，再修復，最後交付差異、驗證命令與結果。檢查它能否獨立找到新項目的相關文件，而不是照抄舊路徑或舊版本號。
至少覆蓋以下情況：正常輸入能完成；缺少失敗日誌時會先補齊證據；無法復現或外部服務不可用時會停止並説明限制；請求超出授權目錄時不會自行擴大範圍。測試失敗就修訂相應步驟，再用該情形複測，不以“已導入”代替可用性驗證。
只有這次環境才成立的修復留在 Capsule；跨任務仍成立的判斷與步驟寫進技能。這樣下次複用的是方法，而不是上一次的偶然條件。
更新與回退
更新前保留當前技能和來源標識，比較 SKILL.md 與腳本的變化。不要把同名覆蓋當作自動升級；權限擴大、新增網絡調用或刪除步驟都需要重新審閲。
新版本異常時，停止使用並恢復上一個已驗證版本，再用原任務複測。不要假設存在通用回收站。具體流程見技能版本。
常見問題
- 導入後無法完成任務：檢查依賴、可用工具和輸入材料，而不只是文件是否存在。
- 技能要求了額外權限：説明中的要求不會自動變成授權。
- 同名技能內容不同：比較來源、版本和實際內容後再處理衝突。
- 想分享給團隊：先去除個人路徑、秘密和內部材料，再提供適用環境與驗證方法。