自我提升技能 是做什麼的?
將學習和錯誤記錄到 Markdown 檔案中,以實現持續改進。編碼代理之後可以將這些記錄處理成修正,而重要的學習成果則會被提升到專案記憶中。
快速參考
| 情境 | 動作 |
|---|---|
| 指令/操作失敗 | 記錄到 .learnings/ERRORS.md |
| 用戶糾正你 | 記錄到 .learnings/LEARNINGS.md,類別為 correction |
| 用戶想要缺少的功能 | 記錄到 .learnings/FEATURE_REQUESTS.md |
| API/外部工具失敗 | 記錄到 .learnings/ERRORS.md,包含整合細節 |
| 知識已過時 | 記錄到 .learnings/LEARNINGS.md,類別為 knowledge_gap |
| 發現更好方法 | 記錄到 .learnings/LEARNINGS.md,類別為 best_practice |
| 簡化/強化重複模式 | 記錄/更新 .learnings/LEARNINGS.md,帶有 Source: simplify-and-harden 和穩定的 Pattern-Key |
| 類似於現有條目 | 使用 **See Also** 連結,考慮提升優先級 |
| 廣泛適用的學習成果 | 提升到 CLAUDE.md、AGENTS.md 和/或 .github/copilot-instructions.md |
| 工作流程改進 | 提升到 AGENTS.md(OpenClaw 工作區) |
| 工具陷阱 | 提升到 TOOLS.md(OpenClaw 工作區) |
| 行為模式 | 提升到 SOUL.md(OpenClaw 工作區) |
OpenClaw 設定(建議)
OpenClaw 是此技能的主要平台。它使用基於工作區的提示注入,並自動載入技能。
安裝
透過 ClawdHub(建議):
clawdhub install self-improving-agent
手動:
git clone https://github.com/peterskoett/self-improving-agent.git ~/.openclaw/skills/self-improving-agent
從原始儲存庫重組以適用於 openclaw:https://github.com/pskoett/pskoett-ai-skills - https://github.com/pskoett/pskoett-ai-skills/tree/main/skills/self-improvement
工作區結構
OpenClaw 將會話注入這些檔案:
~/.openclaw/workspace/
├── AGENTS.md # 多代理工作流程、委派模式
├── SOUL.md # 行為指南、個性、原則
├── TOOLS.md # 工具能力、整合陷阱
├── MEMORY.md # 長期記憶(僅限主要會話)
├── memory/ # 每日記憶檔案
│ └── YYYY-MM-DD.md
└── .learnings/ # 此技能的日誌檔案
├── LEARNINGS.md
├── ERRORS.md
└── FEATURE_REQUESTS.md
建立學習檔案
mkdir -p ~/.openclaw/workspace/.learnings
然後建立日誌檔案(或從 assets/ 複製):
LEARNINGS.md— 修正、知識差距、最佳實踐ERRORS.md— 指令失敗、例外FEATURE_REQUESTS.md— 用戶請求的功能
提升目標
當學習成果被證實廣泛適用時,將其提升到工作區檔案:
| 學習類型 | 提升至 | 範例 |
|---|---|---|
| 行為模式 | SOUL.md | 「保持簡潔,避免免責聲明」 |
| 工作流程改進 | AGENTS.md | 「為長時間任務產生子代理」 |
| 工具陷阱 | TOOLS.md | 「Git push 需要先設定驗證」 |
跨會話通訊
OpenClaw 提供工具來跨會話共享學習成果:
- sessions_list — 檢視有效/最近的會話
- sessions_history — 讀取另一個會話的記錄
- sessions_send — 將學習成果傳送給另一個會話
- sessions_spawn — 產生一個子代理進行背景工作
可選:啟用鉤子
為了在會話開始時自動提醒:
# 將鉤子複製到 OpenClaw 鉤子目錄
cp -r hooks/openclaw ~/.openclaw/hooks/self-improvement
# 啟用它
openclaw hooks enable self-improvement
請參閱 references/openclaw-integration.md 以取得完整詳細資訊。
通用設定(其他代理)
對於 Claude Code、Codex、Copilot 或其他代理,請在專案中建立 .learnings/:
mkdir -p .learnings
從 assets/ 複製範本,或使用標題建立檔案。
在代理檔案 AGENTS.md、CLAUDE.md 或 .github/copilot-instructions.md 中新增參考,以提醒自己記錄學習。 (這是基於鉤子提醒的替代方案)
自我改進工作流程
當錯誤或修正發生時:
- 記錄到
.learnings/ERRORS.md、LEARNINGS.md或FEATURE_REQUESTS.md - 檢閱並將廣泛適用的學習成果提升到:
CLAUDE.md- 專案事實和慣例AGENTS.md- 工作流程和自動化.github/copilot-instructions.md- Copilot 上下文
記錄格式
學習條目
附加到 .learnings/LEARNINGS.md:
## [LRN-YYYYMMDD-XXX] 類別
**記錄時間**:ISO-8601 時間戳記
**優先級**:低 | 中 | 高 | 關鍵
**狀態**:待處理
**領域**:前端 | 後端 | 基礎設施 | 測試 | 文件 | 設定
### 摘要
所學內容的一行描述
### 詳細資訊
完整上下文:發生了什麼、什麼錯了、什麼是正確的
### 建議行動
要進行的具體修復或改進
### 元數據
- 來源:對話 | 錯誤 | 用戶反饋
- 相關檔案:path/to/file.ext
- 標籤:tag1, tag2
- 另請參閱:LRN-20250110-001(如果與現有條目相關)
- 模式鍵:simplify.dead_code | harden.input_validation(可選,用於追蹤重複模式)
- 重複次數:1(可選)
- 首次出現:2025-01-15(可選)
- 最近出現:2025-01-15(可選)
---
錯誤條目
附加到 .learnings/ERRORS.md:
## [ERR-YYYYMMDD-XXX] 技能或指令名稱
**記錄時間**:ISO-8601 時間戳記
**優先級**:高
**狀態**:待處理
**領域**:前端 | 後端 | 基礎設施 | 測試 | 文件 | 設定
### 摘要
失敗內容的簡短描述
### 錯誤
實際的錯誤訊息或輸出
### 上下文
- 嘗試的指令/操作
- 使用的輸入或參數
- 環境詳細資訊(如果相關)
### 建議的修正
如果可以確定,可能是什麼可以解決此問題
### 元數據
- 可重現:是 | 否 | 未知
- 相關檔案:path/to/file.ext
- 另請參閱:ERR-20250110-001(如果重複出現)
---
功能請求條目
附加到 .learnings/FEATURE_REQUESTS.md:
## [FEAT-YYYYMMDD-XXX] 功能名稱
**記錄時間**:ISO-8601 時間戳記
**優先級**:中
**狀態**:待處理
**領域**:前端 | 後端 | 基礎設施 | 測試 | 文件 | 設定
### 請求的功能
用戶想要做什麼
### 用戶上下文
為什麼他們需要它,他們正在解決什麼問題
### 複雜度估計
簡單 | 中等 | 複雜
### 建議的實作
這可以如何構建,它可能擴展什麼
### 元數據
- 頻率:首次 | 重複
- 相關功能:existing_feature_name
---
ID 生成
格式:TYPE-YYYYMMDD-XXX
- TYPE:
LRN(學習)、ERR(錯誤)、FEAT(功能) - YYYYMMDD:目前日期
- XXX:序號或隨機 3 個字元(例如
001、A7B)
範例:LRN-20250115-001、ERR-20250115-A3F、FEAT-20250115-002
解決條目
當問題被修復時,更新條目:
- 將
**Status**: pending更改為**Status**: resolved - 在元數據之後新增解決區塊:
### 解決方案
- **解決時間**:2025-01-16T09:00:00Z
- **提交/PR**:abc123 或 #42
- **備註**:所做內容的簡短描述
其他狀態值:
in_progress- 正在積極處理中wont_fix- 決定不處理(在解決方案備註中新增原因)promoted- 提升到 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md
提升到專案記憶
當學習成果廣泛適用時(不是一次性修復),將其提升到永久專案記憶。
何時提升
- 學習成果適用於多個檔案/功能
- 任何貢獻者(人類或 AI)都應該知道的知識
- 防止重複錯誤
- 記錄專案特定的慣例
提升目標
| 目標 | 應放置的內容 |
|---|---|
CLAUDE.md | 專案事實、慣例、所有 Claude 互動的陷阱 |
AGENTS.md | 代理特定的工作流程、工具使用模式、自動化規則 |
.github/copilot-instructions.md | GitHub Copilot 的專案上下文和慣例 |
SOUL.md | 行為指南、溝通風格、原則(OpenClaw 工作區) |
TOOLS.md | 工具能力、使用模式、整合陷阱(OpenClaw 工作區) |
如何提升
- 提煉 學習成果成為一個簡潔的規則或事實
- 新增 到目標檔案中的適當章節(如果需要,建立檔案)
- 更新 原始條目:
- 將
**Status**: pending更改為**Status**: promoted - 新增
**Promoted**: CLAUDE.md、AGENTS.md或.github/copilot-instructions.md
- 將
提升範例
學習成果(冗長):
專案使用 pnpm 工作區。嘗試
npm install但失敗。 鎖定檔案是pnpm-lock.yaml。必須使用pnpm install。
在 CLAUDE.md 中(簡潔):
## 構建與依賴項
- 套件管理器:pnpm(不是 npm)- 使用 `pnpm install`
學習成果(冗長):
修改 API 端點時,必須重新生成 TypeScript 客戶端。 忘記此步驟會導致執行時期類型不匹配。
在 AGENTS.md 中(可操作):
## API 變更後
1. 重新生成客戶端:`pnpm run generate:api`
2. 檢查類型錯誤:`pnpm tsc --noEmit`
重複模式偵測
如果記錄的內容與現有條目相似:
- 先搜尋:
grep -r "keyword" .learnings/ - 連結條目:在元數據中新增
**See Also**: ERR-20250110-001 - 提升優先級,如果問題持續重複出現
- 考慮系統性修復:重複出現的問題通常表示:
- 缺少文件(→ 提升到 CLAUDE.md 或 .github/copilot-instructions.md)
- 缺少自動化(→ 新增到 AGENTS.md)
- 架構問題(→ 建立技術債務票據)
簡化與強化饋送
使用此工作流程來攝取來自 simplify-and-harden 技能的重複模式,並將它們轉化為持久的提示指導。
攝取工作流程
- 從任務摘要中讀取
simplify_and_harden.learning_loop.candidates。 - 對於每個候選項,使用
pattern_key作為穩定的去重鍵。 - 在
.learnings/LEARNINGS.md中搜尋具有該鍵的現有條目:grep -n "Pattern-Key: <pattern_key>" .learnings/LEARNINGS.md
- 如果找到:
- 增加
Recurrence-Count - 更新
Last-Seen - 新增
See Also連結到相關條目/任務
- 增加
- 如果未找到:
- 建立一個新的
LRN-...條目 - 設定
Source: simplify-and-harden - 設定
Pattern-Key、Recurrence-Count: 1以及First-Seen/Last-Seen
- 建立一個新的
提升規則(系統提示回饋)
當以下所有條件都成立時,將重複模式提升到代理上下文/系統提示檔案中:
Recurrence-Count >= 3- 在至少 2 個不同的任務中出現
- 發生在 30 天的時間範圍內
提升目標:
CLAUDE.mdAGENTS.md.github/copilot-instructions.mdSOUL.md/TOOLS.md(適用於 OpenClaw 工作區層級的指導)
將提升的規則寫成簡短的預防規則(在編碼之前或期間要做什麼),而不是冗長的事件描述。
定期檢閱
在自然的休息點檢閱 .learnings/:
何時檢閱
- 開始新的主要任務之前
- 完成一個功能之後
- 在過去有學習成果的領域工作時
- 在活躍開發期間每週一次
快速狀態檢查
# 計算待處理項目
```bash
grep -h "Status\*\*: pending" .learnings/*.md | wc -l
列出待處理的高優先級項目
grep -B5 "Priority\*\*: high" .learnings/*.md | grep "^## \["
查找特定領域的學習成果
grep -l "Area\*\*: backend" .learnings/*.md
檢閱動作
- 解決已修復的項目
- 提升適用的學習成果
- 連結相關條目
- 升級重複出現的問題
偵測觸發器
當你注意到以下情況時,自動記錄:
修正(→ 帶有 correction 類別的學習成果):
- 「不,那不是對的……」
- 「實際上,它應該是……」
- 「你錯了……」
- 「那已經過時了……」
功能請求(→ 功能請求):
- 「你也可以……」
- 「我希望你可以……」
- 「有沒有辦法……」
- 「為什麼你不能……」
知識差距(→ 帶有 knowledge_gap 類別的學習成果):
- 用戶提供了你不知道的資訊
- 你參考的文件已過時
- API 的行為與你的理解不同
錯誤(→ 錯誤條目):
- 指令返回非零退出碼
- 例外或堆疊追蹤
- 非預期的輸出或行為
- 超時或連線失敗
優先級指南
| 優先級 | 何時使用 |
|---|---|
關鍵 | 阻塞核心功能、資料遺失風險、安全問題 |
高 | 顯著影響、影響常見工作流程、重複出現的問題 |
中 | 中度影響、存在解決方案 |
低 | 輕微不便、邊緣案例、有也不錯 |
領域標籤
用於按程式碼庫區域過濾學習成果:
| 領域 | 範圍 |
|---|---|
前端 | UI、元件、客戶端程式碼 |
後端 | API、服務、伺服器端程式碼 |
基礎設施 | CI/CD、部署、Docker、雲端 |
測試 | 測試檔案、測試工具、涵蓋率 |
文件 | 文件、註解、README |
設定 | 設定檔案、環境、設定 |
最佳實踐
- 立即記錄 - 問題發生時上下文最新鮮
- 具體明確 - 未來的代理需要快速理解
- 包含重現步驟 - 特別是對於錯誤
- 連結相關檔案 - 使修復更容易
- 建議具體的修正 - 而不僅僅是「調查」
- 使用一致的類別 - 啟用篩選功能
- 積極提升 - 如果有疑問,請新增到 CLAUDE.md 或 .github/copilot-instructions.md
- 定期檢閱 - 過時的學習會失去價值
Gitignore 選項
將學習保留在本地(每個開發者):
.learnings/
在儲存庫中追蹤學習(團隊範圍):\n不要新增到 .gitignore - 學習成果成為共享知識。
混合(追蹤範本,忽略條目):
.learnings/*.md
!.learnings/.gitkeep
鉤子整合
透過代理鉤子啟用自動提醒。這是選擇性加入 - 你必須明確設定鉤子。
快速設定(Claude Code / Codex)
…
[已截斷以進行翻譯]