claude-code/claude-zh/commands/evolve.md

5.2 KiB
Raw Blame History

name description command
evolve 將相關的直覺 (Instincts) 聚類為技能 (Skills)、指令 (Commands) 或 Agent (Agents) true

演進指令 (Evolve Command)

實作方式

使用外掛程式根路徑執行直覺 CLI

python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" evolve [--generate]

或者,如果未設定 CLAUDE_PLUGIN_ROOT (手動安裝)

python3 ~/claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]

此指令會分析直覺,並將相關聯的直覺聚類為更高層級的結構:

  • 指令 (Commands):當直覺描述了使用者呼叫的動作時。
  • 技能 (Skills):當直覺描述了自動觸發的行為時。
  • Agent (Agents):當直覺描述了複雜的多步驟流程時。

使用方式

/evolve                    # 分析所有直覺並建議演進方向
/evolve --domain testing   # 僅對測試領域的直覺進行演進
/evolve --dry-run          # 顯示將會建立的內容,而不實際建立
/evolve --threshold 5      # 需要 5 個以上相關直覺才進行聚類

演進規則

→ 指令 (使用者呼叫)

當直覺描述了使用者明確要求的動作時:

  • 多則關於「當使用者要求...」的直覺。
  • 具有「當建立新的 X 時」等觸發條件的直覺。
  • 遵循可重複序列的直覺。

範例:

  • new-table-step1:「新增資料庫表格時,建立 migration」
  • new-table-step2:「新增資料庫表格時,更新 schema」
  • new-table-step3:「新增資料庫表格時,重新生成型別」

→ 演進為:new-table 指令

→ 技能 (自動觸發)

當直覺描述了應自動發生的行為時:

  • 模式匹配觸發器 (Pattern-matching triggers)。
  • 錯誤處理回應。
  • 程式碼風格強制執行。

範例:

  • prefer-functional:「撰寫函式時,優先使用函式式風格」
  • use-immutable:「修改狀態時,使用不可變模式」
  • avoid-classes:「設計模組時,避免使用類別導向設計」

→ 演進為:functional-patterns 技能

→ Agent (需要深度/隔離)

當直覺描述了受益於隔離的複雜多步驟流程時:

  • 偵錯工作流。
  • 重構序列。
  • 研究任務。

範例:

  • debug-step1:「偵錯時,先檢查日誌」
  • debug-step2:「偵錯時,隔離故障元件」
  • debug-step3:「偵錯時,建立最小重現範例」
  • debug-step4:「偵錯時,透過測試驗證修復」

→ 演進為:debugger Agent

操作步驟

  1. ~/.claude/homunculus/instincts/ 讀取所有直覺。
  2. 依據以下條件將直覺分組:
    • 領域相似性。
    • 觸發模式重疊。
    • 動作序列關聯。
  3. 針對每個由 3 個以上相關直覺組成的群聚:
    • 確定演進類型 (指令/技能/Agent)。
    • 生成對應檔案。
    • 儲存至 ~/.claude/homunculus/evolved/{commands,skills,agents}/
  4. 將演進後的結構連結回來源直覺。

輸出格式

🧬 演進分析 (Evolve Analysis)
==================

發現 3 個準備好演進的群聚:

## 群聚 1資料庫遷移工作流 (Database Migration Workflow)
直覺new-table-migration, update-schema, regenerate-types
類型:指令 (Command)
置信度85% (基於 12 次觀察)

將建立:/new-table 指令
檔案:
  - ~/.claude/homunculus/evolved/commands/new-table.md

## 群聚 2函式式程式碼風格 (Functional Code Style)
直覺prefer-functional, use-immutable, avoid-classes, pure-functions
類型:技能 (Skill)
置信度78% (基於 8 次觀察)

將建立functional-patterns 技能
檔案:
  - ~/.claude/homunculus/evolved/skills/functional-patterns.md

## 群聚 3偵錯流程 (Debugging Process)
直覺debug-check-logs, debug-isolate, debug-reproduce, debug-verify
類型Agent
置信度72% (基於 6 次觀察)

將建立debugger Agent
檔案:
  - ~/.claude/homunculus/evolved/agents/debugger.md

---
執行 `/evolve --execute` 以建立這些檔案。

旗標 (Flags)

  • --execute:實際建立演進後的結構 (預設為預覽)
  • --dry-run:預覽而不實際建立
  • --domain <name>:僅對指定領域的直覺進行演進
  • --threshold <n>:形成群聚所需的最小直覺數量 (預設為 3)
  • --type <command|skill|agent>:僅建立指定類型

生成檔案格式

指令 (Command)

---
name: new-table
description: 透過 migration、schema 更新與型別生成來建立新的資料庫表格
command: /new-table
evolved_from:
  - new-table-migration
  - update-schema
  - regenerate-types
---

# New Table 指令

[基於聚類直覺生成的內容]

## 步驟
1. ...
2. ...

技能 (Skill)

---
name: functional-patterns
description: 強制執行函式式程式設計模式
evolved_from:
  - prefer-functional
  - use-immutable
  - avoid-classes
---

# 函式式模式技能 (Functional Patterns Skill)

[基於聚類直覺生成的內容]

Agent

---
name: debugger
description: 系統性偵錯 Agent
model: sonnet
evolved_from:
  - debug-check-logs
  - debug-isolate
  - debug-reproduce
---

# 偵錯 Agent (Debugger Agent)

[基於聚類直覺生成的內容]