Kulaxyz/self-learning-skills

self‑learning‑skills – AI 編碼代理的元技能

它是什麼

• 一個微小的「技能」，可以添加到任何 AI 驅動的編碼助手（Claude Code、Cursor、Codex、Aider、Gemini‑CLI、Zed 等）。
• 它的目的不是編寫程式碼本身，而是記住代理在除錯或部署過程中發現的步驟，並在未來的會話中自動重播它們。

為什麼它很重要

• 當您使用基於 LLM 的代理時，每次開始新會話時，通常必須重複相同的「我該如何連接生產資料庫？」或「部署指令是什麼？」的發現過程。此技能捕捉那些得來不易的「黃金路徑」（包括無效的方法），並將其儲存在代理下次可以自動載入的地方，將臨時的故障排除轉化為可重複使用的知識。

運作方式

1. 識別 – 該技能會監控代理的輸出以尋找提示（例如，您說*“記住這個”*，或者代理在多次嘗試後終於成功）。
2. 捕捉 – 它會建立一個簡潔、獨立的程序描述（或單一事實），如果相關，還會包含關於避免了哪些失敗嘗試的註記。
3. 重複使用 – 在下一個會話中，儲存的條目會自動載入，作為新的技能（用於多步驟工作流程）或輕量級筆記（用於單一事實）。代理隨後無需重新推導步驟即可應用它。

工具特定的持久化

代理 / 工具	知識寫入位置	如何自動載入
Claude Code, Codex, 其他 Agent Skills 客戶端	skills/<name>/SKILL.md	Agent Skills 框架的技能匹配邏輯
Cursor	.cursor/rules/learned/<name>.mdc	Cursor 的規則匹配機制
Zed, Aider, Gemini‑CLI, 任何讀取 AGENTS.md 的工具	AGENTS.md (或專案範圍筆記)	每次啟動時讀取該檔案

安裝選項

• 透過 npx 的單行指令（推薦） – 偵測已安裝的代理並放入適當的檔案：

  npx skills add kulaxyz/self-learning-skills          # 本地於當前專案
  npx skills add kulaxyz/self-learning-skills -g      # 全域於所有專案
  npx skills add kulaxyz/self-learning-skills -a claude-code  # 僅限 Claude Code
  

• Claude Code 外掛程式 – 透過內建市場添加：

  /plugin marketplace add kulaxyz/self-learning-skills
  /plugin install self-learning@self-learning-skills
  

• 手動複製 – 克隆儲存庫並將相關目錄/檔案複製到適當位置（請參閱 README 的“Manual”部分）。

提升規則（品質守門員） 只有在滿足所有三個條件時，捕捉到的條目才會成為技能：

1. 程序已驗證（測試通過、建置成功等）。
2. 明確命名了它所避免的失敗模式。
3. 記錄了至少一個已嘗試並排除的死胡同。 如果缺少任何條件，該條目將保持為臨時筆記或被丟棄，防止未經驗證的猜測污染技能集。

安全考量

• 該技能絕不會寫入實際的密鑰值。它只記錄密鑰的位置（例如環境變數名稱、密鑰管理器查找）。
• 由於產生的檔案旨在提交，設計刻意避免洩漏憑證。

儲存庫佈局（快速地圖）

self-learning-skills/
├─ AGENTS.md                # 適用於任何支援 AGENTS 的工具的通用循環描述
├─ skills.sh.json           # `npx skills` 安裝程式的清單
├─ .claude-plugin/…         # Claude Code 市場元資料
├─ skills/self-learning/    # 核心技能檔案 (SKILL.md, 範本, 文件)
└─ .cursor/rules/…          # Cursor 規則和 learned‑rules 資料夾

典型使用案例

1. 您開始與 LLM 代理進行除錯會話。
2. 經過幾次嘗試，您終於發現了遷移資料庫的正確指令。
3. 您說*“記住這個”*（或者技能自動偵測到成功）。
4. 該技能寫入一個 SKILL.md（或 Cursor 的 .mdc），描述遷移步驟和失敗的嘗試。
5. 在下一個會話中，代理自動載入該技能，無需您再次進行試錯即可執行遷移。

限制

• 它依賴於底層代理支援 Agent‑Skills 標準或讀取 AGENTS.md；沒有此類掛鉤的工具無法受益。
• “識別時刻”的偵測是啟發式的；如果錯過了提示，知識將不會被捕捉。
• 提升規則需要通過驗證步驟，因此純資訊性事實（例如“生產資料庫 URL 在 DATABASE_URL 中”）將僅作為輕量級筆記儲存，而不是作為可執行技能。

授權

• MIT © kulaxyz (參閱 LICENSE)。