前言¶

長期用 Agent 做開發或寫作，對話裏往往已經出現過可複用的做法和踩坑記錄，但任務一結束就散在上下文裏，下次類似需求又要從頭摸索。手工寫復盤文檔成本高，通用記憶文件也不一定能按「場景—方法—教訓」結構化沉澱。下面介紹 SkillHub 社區技能 Agent經驗提煉（@user_ef64daef/jingyantilian）：從任務執行中抽取經驗，生成方法論卡片，並支持檢索、關聯推薦與導出，便於 Agent 持續積累個人方法庫。

這是什麼¶

Agent經驗提煉 是面向 Agent 工作流的 Skill，遵循通用 SKILL.md 格式。發佈者爲 SkillHub 用戶 user_ef64daef（頁面標註作者「洋洋」），來源爲 community，分類 ai-agent，當前商店版本 1.0.1，標籤 requires_api_key=false，無需額外 API Key。

官方簡介：智能從任務執行中提取可複用經驗，生成方法論卡片，幫助 Agent 持續成長；支持多種觸發方式（手動/自動）、多種輸入方式（手動輸入/對話歷史/記憶文件）、多種輸出（經驗卡片/方法論列表/改進計劃），以及智能檢索與提醒。

核心功能¶

以下能力均來自官方頁面簡介與技能包內 SKILL.md、腳本模塊說明。

經驗卡片與輸出形態¶

根據任務信息生成結構化經驗卡片，字段覆蓋場景、方法、避坑、效果評估、延伸應用與標籤等。除單張卡片外，還可整理爲方法論列表、改進計劃（失敗復盤場景在文檔中單獨描述爲「教訓卡片」）。

觸發方式¶

手動觸發（主觸發詞示例）：

• /經驗提煉
• /復盤
• /經驗總結
• /方法論
• /從經驗學習

自動觸發（文檔約定）：任務完成後可詢問是否提煉；遇到類似任務時可檢索歷史經驗；支持按日/周做批量整理（需與 Agent 的提醒能力配合）。

輸入來源¶

技能包內提供 input_processor.py 等模塊處理多源輸入；默認經驗庫存儲路徑在配置中爲 ./data/experience_db.json（可通過配置覆蓋）。

關聯推薦、檢索與庫管理¶

• 關聯推薦：按標籤重疊、任務類型、技能重疊、關鍵詞與場景相似度等維度關聯歷史經驗，單次推薦上限 5 條（可在配置中調整 max_recommendations）。
• 檢索：文檔約定最小相似度約 0.6、單次最多 10 條結果，並有時效性與價值權重；可用自然語言查詢，例如「有沒有關於代碼開發的相關經驗」。
• 去重與版本：相似度超過約 70% 時可提示合併/覆蓋/並存；卡片支持版本歷史記錄。
• 導出：支持 Markdown、JSON、CSV、PDF；可全量、篩選或單條導出（exporter.py）。

配套腳本¶

安裝後的技能目錄包含 scripts/：主入口 main.py 協調卡片生成、輸入處理、關聯推薦、導出、庫管理與檢索（experience_card_generator.py、relation_recommender.py、retriever.py 等）。Agent 在對話中按 SKILL.md 流程執行即可；需要本地批處理時，可在技能目錄下用 Python 調用 ExperienceRefiningSkill（以包內 main.py 爲準）。

安裝與啓用¶

安裝前確認本機已有 SkillHub CLI；完整說明見 SkillHub 安裝與優先源配置。

1、檢查 CLI：

command -v skillhub && skillhub --version

未安裝時可按官方文檔執行（示例爲完整安裝）：

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

2、安裝本技能。官方頁面與 CLI 搜索結果的安裝形式爲：

skillhub install jingyantilian --namespace user_ef64daef --dir <當前 Agent 的 skills 目錄>

必須使用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不被加載。常用路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可將提示詞交給 AI，讓其按 https://skillhub.cn/install/skillhub.md 安裝 @user_ef64daef/jingyantilian。

3、安裝完成後重啓或重新加載 Agent，使新 Skill 生效。商店側該技能 requires_api_key=false，一般無需額外密鑰配置。

典型用法¶

經過上面的步驟啓用技能後，可按文檔中的對話式流程操作。

快速提煉單條經驗：發送 /經驗提煉，按提示補充任務類型、目標、過程與結果，Agent 生成經驗卡片並詢問是否寫入經驗庫。

基於對話批量復盤：

幫我復盤一下最近完成的所有任務

Agent 讀取對話歷史並批量生成卡片。

檢索與導出：

有沒有關於代碼開發的相關經驗

導出我的經驗庫爲 JSON

庫維護（文檔提供的指令示例）：/我的經驗 查看列表；/檢查重複 做相似度檢查；/關閉推薦 關閉自動推薦。

配置項（節選，見技能包 scripts/config.py 默認值）：storage_path、min_similarity（0.6）、max_results（10）、dedup_similarity_threshold（0.7）、auto_recommend、max_recommendations（5）；SKILL.md 還說明可將卡片自動寫入 TOOLS.md 及自定義存儲路徑、提醒頻率等。

適用場景與注意¶

適合：需要把 Agent 協助完成的任務系統化復盤的個人或小團隊；希望在新任務前檢索「同類場景怎麼做過」；願意維護一份結構化經驗庫並偶爾導出備份的用戶。

注意：

• 自動觸發、定時提醒、PDF 生成等依賴當前 Agent 是否支持對應能力；文檔中的執行約束（如經驗庫少於 3 條時不自動推薦）需在真實數據積累後纔會明顯生效。
• 關聯推薦、相似度與去重閾值在配置與 SKILL.md 中有說明，可按團隊習慣調整。
• SkillHub 頁面列出版本爲 1.0.1；技能包內文檔 frontmatter 可能標註更高文檔版本，以你安裝時 CLI 解析到的包內容爲準。
• 商店統計（截至資料抓取）：評分 100000，下載 2172；安裝數在頁面展示爲 0，僅作商店參考，不代表本地使用情況。

結尾¶

Agent經驗提煉把「做完就忘」的對話經驗，收斂爲可檢索、可關聯、可導出的方法論卡片，適合作爲 ai-agent 類工作流裏的沉澱層。官方 SkillHub 頁面：https://www.skillhub.cn/skills/user_ef64daef/jingyantilian；座標 @user_ef64daef/jingyantilian，API 入口 https://api.skillhub.cn/user_ef64daef/jingyantilian。