evolve

# Self-Evolving Agent v5.11.0 > [**版本檢查**] → **北極星錨定** → [**Worktree 隔離**] → PSB 環境檢查 → 目標分析（**🔗 brainstorming**）→ **自動領域識別** → 評估能力 → 習得技能 → PDCA 執行（**🔗 TDD + verification**）→ 診斷（**🔗 systematic-debugging**）→ 多策略重試 → Repo 記憶 → **定期健檢** → [**Worktree 完成**] → 直到成功 ## 快速導覽 本 skill 採用**原子化架構**，將知識拆分為獨立模組： | 模組 | 用途 | 路徑 | |------|------|------| | **00-getting-started** | 入門與環境設定 | [→](./00-getting-started/) | | **01-core** | 核心流程（PSB + PDCA） | [→](./01-core/) | | **02-checkpoints** | 強制檢查點（護欄） | [→](./02-checkpoints/) | | **03-memory** | 記憶系統操作 | [→](./03-memory/) | | **04-emergence** | 涌現機制 | [→](./04-emergence/) | | **05-integration** | 外部工具整合（含 **superpowers**） | [→](./05-integration/) | | **06-scaling** | 大規模專案優化 | [→](./06-scaling/) | | **99-evolution** | 自我進化機制 | [→](./99-evolution/) | ## 使用方式 ```bash /evolve [目標描述] # 範例 /evolve 建立一個能自動生成遊戲道具圖片的 ComfyUI 工作流程 /evolve 優化這段程式碼的效能，目標是降低 50% 執行時間 /evolve 為這個專案建立完整的測試覆蓋率達到 80% ``` ### Flags ```bash --explore # 探索模式 - 允許自主選擇方向 --emergence # 涌現模式 - 啟用跨領域連結探索 --autonomous # 自主模式 - 完全自主，追求系統性創新 --max-iterations N # 最大迭代次數（預設 10） --from-spec NAME # 從 spec-workflow 的 tasks.md 執行 ``` ## 核心哲學 **人類與 AI 協作的本質：透過抽象化介面溝通** | 傳統軟體 | AI 協作 | 作用 | |----------|---------|------| | API | MCP | 能力邊界（能做什麼） | | SDK/Library | Tools | 具體實作（怎麼做） | | 文檔+實踐 | Skill | 領域知識（何時用什麼） | | Config | CLAUDE.md | 上下文約束（專案規範） | **深層洞察**： - Skill 不只是知識，是「封裝好的判斷力」 - 告訴 AI 在什麼情況下，用什麼方式，達成什麼目標 - 減少決策點 > 讓 AI 自己選擇 ### 設計原則 | 原則 | 說明 | |------|------| | **有主見的設計** | 合理預設值 > 讓 AI 選擇，必填參數 ≤ 2 個 | | **深且窄** | 專注 10% 高價值任務，不追求功能廣度 | | **預期失敗** | 95% Agent 在生產環境失敗是常態，設計優雅降級 | | **增強回饋** | 執行中提醒目標和進度，失敗時說明影響範圍 | ## 執行流程概覽 **Self-Evolving Loop v5.2** 0. 🔄 **版本檢查**（自動）— 檢查更新、詢問用戶、自動更新 1. 🌟 **CP0: 北極星錨定** — 願景、完成標準、不做清單、動機 2. 🔒 **CP0.5: Worktree 隔離**（條件觸發）— Level 2 / autonomous / 並行任務 3. **PSB System** — Plan → Setup → Build（環境準備） 4. **目標分析** — 深度訪談 + 架構等級判斷（Level 2 強制） 5. **能力評估 → Skill 習得** 6. **PDCA Cycle** — Plan → Do → Check → Act（含多策略選擇） - CP3: 方向校正（對照北極星） 7. **Git-based Memory** — 記錄學習經驗 8. 🏥 **CP6: 專案健檢**（每 5 次迭代）— Scope、方向、終止檢查 9. 🏁 **CP6.5: Worktree 完成**（條件觸發）— 合併/清理 ↻ 重複直到：目標達成 或 達到最大迭代次數 > **主要功能**：Superpowers 整合 | LEANN 語義搜尋 | Worktree 隔離 | 北極星系統 | 深度訪談 > > 詳見：[CHANGELOG](../CHANGELOG.md) | [05-integration](./05-integration/) | [02-checkpoints](./02-checkpoints/) ### 架構考量三層設計 | Layer | 階段 | 動作 | |-------|------|------| | 1 | Goal Analysis | 判斷架構等級 (0/1/2) | | 2 | PDCA Plan | 依等級做架構設計 | | 3 | CP1.5 Phase 2 | 驗證實作符合設計 | → 設計 → 實作 → 驗證 閉環 ## 強制檢查點（護欄） > **這些檢查點不可跳過**，詳見 [02-checkpoints](./02-checkpoints/) | 檢查點 | 時機 | 動作 | |--------|------|------| | **CP0** 🌟 | 專案/任務開始前 | 北極星錨定（建立或讀取） | | **CP0.5** 🔒 | CP0 後（條件觸發） | Worktree 隔離環境準備 | | **CP1** | 任務開始前 | 搜尋 .claude/memory/ 查找相關經驗 | | **CP1.5** | 寫程式碼前 | 一致性檢查（兩階段） | | **CP2** | 程式碼變更後 | 編譯 + 測試驗證 | | **CP3** | Milestone 完成後 | 確認目標、**方向校正**、下一步 | | **CP3.5** | Memory 文件創建後 | 立即同步 index.md | | **CP4** | 迭代完成後 | 涌現機會檢查（選擇性） | | **CP5** | PDCA Check 失敗時 | 失敗後驗屍，生成結構化 Lesson | | **CP6** 🏥 | 每 5 次迭代後 | 專案健檢（Scope、方向、終止檢查） | | **CP6.5** 🏁 | 任務完成時（條件觸發） | Worktree 合併/清理 | ### Checkpoint 並行化 效率優化：以下 CP 可並行執行： - **CP1 + CP1.5 Phase 1**：Memory 搜尋與基礎一致性檢查互不依賴，使用 `run_in_background: true` 同時啟動 - **CP4 + 下一迭代 Plan**：涌現檢查在背景運行，不阻塞後續 PDCA 不可並行：CP0/CP0.5 必須先完成；CP1.5 Phase 2 依賴 CP1 結果；CP2 → CP3 為序列關係。 > 詳見 [02-checkpoints/README.md](./02-checkpoints/README.md#checkpoint-並行化) ### CP1.5 兩階段設計 **Phase 1: 基礎檢查（必執行）** - 搜尋現有實作，避免重複造輪子 - 檢查專案慣例（命名、風格） - 檢查 Schema/API 一致性 **Phase 2: 架構檢查（自動偵測觸發）** - 依賴方向、錯誤處理一致性、橫切關注點、設計模式一致性 **觸發條件**：新增目錄/模組、變更涉及 3+ 目錄、新增外部依賴、觸及 core/infra/domain/shared/、新增公開 API ## 停止條件 | 狀態 | 條件 | |------|------| | ✅ 成功 | 所有子目標完成 + 驗收標準通過 | | ❌ 失敗 | 達到最大迭代次數 或 連續 3 次相同錯誤 | | ⏸️ 暫停 | 需要用戶決策 或 風險操作需確認 | ## 完成信號 - `✅ GOAL ACHIEVED: [目標描述]` - `⏸️ NEED HUMAN: [原因]` - `❌ CANNOT COMPLETE: [原因]` ## 相關資源 - [Reflexion Paper](https://arxiv.org/abs/2303.11366) - [OpenAI Self-Evolving Agents Cookbook](https://cookbook.openai.com/examples/partners/self_evolving_agents/autonomous_agent_retraining) - [Andrew Ng - Agentic Design Patterns](https://www.deeplearning.ai/the-batch/agentic-design-patterns-part-2-reflection/)