22:把失敗、糾錯與經驗沉澱成可複用的 Agent 學習記錄

前言

長期用 AI Agent 寫代碼或跑運維時,同類錯誤會在不同會話裏反覆出現:命令偶發失敗、用戶當場糾正、外部 API 報錯、模型發現自己信息過時。會話結束上下文就丟,下一輪又要從零解釋一遍。下面介紹 SkillHub 社區 Skill「22」(座標 @user_be2168d6/11),其定位是捕獲學習點、錯誤與糾正,支撐持續改進;並在重大任務前回顧已沉澱內容。

這是什麼

「22」是發佈者 user_be2168d6 在 SkillHub 上架的社區 Skill,分類爲 ai-agent,當前版本 1.0.0,標籤標明 requires_api_key=false,無需額外 API Key。官方簡介用一句話概括能力:Captures learnings, errors, and corrections to enable continuous improvement(記錄學習、錯誤與糾正,以支持持續改進)。

維護與分發入口:

核心功能

依據 SkillHub 頁面與元數據,可覈實的能力邊界如下。

  1. 記錄學習(learnings)
    在對話或任務過程中,把值得保留的結論、做法寫下來,供後續會話引用。

  2. 記錄錯誤(errors)
    當命令、操作或外部工具失敗時,把失敗情境納入學習記錄,減少同類問題重複踩坑。

  3. 記錄糾正(corrections)
    用戶明確否定或修正 Agent 輸出時(例如指出「不對」「其實應該……」),將糾正內容結構化保存。

  4. 重大任務前的回顧
    官方說明要求在開展重大任務之前,先回顧已有 learnings,避免重複舊錯。

  5. 觸發場景(官方列舉)
    Skill 說明中寫明應在以下情況使用(原文要點,未展開實現細節):

  • 命令或操作意外失敗;
  • 用戶糾正 Claude(如 “No, that’s wrong…”“Actually…”);
  • 用戶請求尚不存在的能力;
  • 外部 API 或工具失敗;
  • Agent 意識到自身知識過時或不正確;
  • 針對重複任務發現了更好的做法。

本 Skill 遵循通用 SKILL.md 格式;頁面未公開更細的存儲路徑、文件命名或 CLI 子命令,正文不臆測這些內容。

安裝與啓用

安裝流程以 SkillHub 官方安裝文檔爲準。頁面給出的提示是:讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_be2168d6/11。

1、檢查 SkillHub CLI

先確認本機是否已有 skillhub:

command -v skillhub && skillhub --version

若未安裝,可按安裝文檔執行完整安裝(CLI + 默認 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅需 CLI 時:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安裝到當前 Agent 的 skills 目錄

安裝技能時必須用 --dir 指向當前客戶端識別的 skills 目錄;否則默認落在 ./skills/,Agent 可能無法加載。

skillhub install user_be2168d6/11 --dir <skills 目錄>

安裝文檔中列出的常見路徑(按你實際使用的客戶端選用其一):

客戶端 skills 目錄
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或項目下 .agents/skills/
Gemini CLI ~/.gemini/skills/

座標寫法以 SkillHub 頁面爲準:@user_be2168d6/11;CLI 搜索與安裝時通常使用 user_be2168d6/11 或 skillhub search 查到的標識。安裝後若客戶端要求重啓或重新加載 skills,按該客戶端說明操作。

典型用法

公開資料未提供可複製粘貼的端到端命令示例,但 何時應啓用本 Skill 在簡介中寫得很具體。下面按官方場景整理爲可復現的工作流(由 Agent 在啓用 Skill 後按 SKILL.md 執行,而非獨立腳本)。

  1. 命令失敗
    某條 shell 或工具調用失敗後,讓 Agent 在修復問題的同時,把失敗原因與最終可行做法記入 learnings。

  2. 用戶糾錯
    用戶否定當前方案時,要求 Agent 更新理解並寫入 corrections,避免下次仍按錯誤假設推進。

  3. 能力缺口
    用戶提出當前環境不具備的能力時,記錄需求與臨時替代方案,便於後續擴展或人工接手。

  4. 外部依賴失敗
    API 或 MCP 工具報錯時,記錄錯誤碼、環境與恢復步驟。

  5. 知識過時
    Agent 自行發現文檔或 API 與現狀不符時,記錄更正後的事實來源(在 SKILL 允許範圍內)。

  6. 流程優化
    對重複任務摸索出更短路徑後,寫入 learnings,供「重大任務前回顧」使用。

適用場景與注意

適合誰

  • 長期在同一倉庫或同一產品線使用 Cursor、Claude Code、Codex 等 Agent 的開發者;
  • 希望把「踩坑—糾正—更好做法」從單次對話裏抽出來、形成團隊可繼承上下文的個人或小團隊。

限制與注意

  • 頁面元數據顯示 安裝次數爲 0(以抓取時 SkillHub 統計爲準),實際體驗取決於你是否把 Skill 裝到正確的 --dir 路徑。
  • 無需 API Key,但學習記錄的持久化方式、隱私範圍以安裝後的 SKILL.md 爲準;公開頁面未描述同步或共享機制,不宜假設有云端備份。
  • 評分與下載量爲平臺統計(抓取時評分 100000,下載 3444),僅作熱度參考,不代表質量背書。
  • 名稱「22」無額外副標題,在 skillhub search 時建議用座標 user_be2168d6/11 精確定位。

結尾

「22」解決的是 Agent 會話之間經驗流失的問題:把失敗、用戶糾正和更好做法寫成可回顧的學習記錄,並在大任務前先看一遍。若你要安裝,從 SkillHub 頁面與安裝文檔入手即可。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜