前言¶
Agent 每次新開 Session,上下文往往從零開始。用戶需要重複說明偏好、項目背景和上次討論的結論,既費時間,也容易讓模型在首輪迴復裏漏掉關鍵約束。常見做法是手動粘貼筆記,或在系統提示裏堆長期說明,但維護成本高,且很難覆蓋「工作記憶」與歷史對話裏散落的細節。
下面介紹 SkillHub 上的社區 Skill「記憶召回」(@user_ce858ad4/memory-recall),目標是在新對話的第一條回覆之前,先讀取工作記憶與對話歷史,把用戶記憶、偏好和項目上下文帶進當前 Session。
這是什麼¶
「記憶召回」是面向 ai-agent 分類的通用 SKILL.md 格式技能,當前版本 1.0.1,來源爲 community,發佈座標 @user_ce858ad4/memory-recall。SkillHub 頁面標註作者爲 Wyman Ho。標籤 requires_api_key=false,表示按官方說明安裝使用時不需要額外配置 API Key。
一句話定位:Session 啓動時的記憶召回——在 Agent 首次回覆前讀取 working memory 與 conversation history,讓新會話儘量延續「認識你」的上下文,而不是空窗開局。
核心功能¶
依據 SkillHub 官方簡介,已覈實的能力包括:
- 新對話啓動時自動召回:在用戶開始新 Session 時觸發,而非中途手動點選。
- 讀取工作記憶與對話歷史:在第一條回覆之前完成讀取,再進入正常對話流程。
- 覆蓋三類上下文:用戶記憶、偏好、以及項目相關上下文(具體存儲形態由 Skill 內指令與 Agent 環境決定,官方簡介未展開實現細節)。
- 觸發語義:官方列出的觸發詞包括中文與英文,例如「新對話」「開始」「首次」「回憶」「記憶」「上下文」「session start」「first message」「recall memory」「記住我」「之前說過」「上次」「繼續」「歷史記錄」等,便於自然語言或工作流在「開局」場景下喚起該 Skill。
英文簡述與中文一致:Session-start memory recall. Reads working memory and conversation history before first response, so the agent starts every new conversation with full user context.
安裝與啓用¶
SkillHub 頁面給出的安裝指引是:讓 Agent 按 SkillHub 安裝與優先源配置 文檔操作,並安裝座標 @user_ce858ad4/memory-recall。
1、安裝 SkillHub CLI(若尚未安裝)¶
先檢查是否已有 CLI:
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 指向當前 Agent 實際識別的 skills 目錄,否則默認會裝到 ./skills/,可能無法被加載。
skillhub install user_ce858ad4/memory-recall --dir <skills 目錄>
常見客戶端路徑(摘自 SkillHub 安裝文檔,按你實際使用的客戶端選擇其一):
| 客戶端 | skills 目錄示例 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝後若 Agent 需要重啓才能加載新 Skill,以你所用客戶端的文檔爲準。官方安裝說明提到部分環境安裝到正確目錄後仍可能需要重啓。
3、頁面提示詞方式(可選)¶
SkillHub 技能頁也提供「將提示詞發送給你的 AI 安裝該 skills」的文案,等價於:
請根據 https://skillhub.cn/install/skillhub.md,安裝
@user_ce858ad4/memory-recall。
適合在已具備 Skill 安裝能力的對話裏,由 Agent 按文檔完成 search/install。
典型用法¶
官方未提供獨立的多步教程或示例倉庫;可復現的用法來自簡介與觸發設計:
- 安裝並啓用 Skill 後,新開一個對話(新 Session),不要用舊線程冒充「新對話」。
- 在首輪消息裏使用與「開始 / 回憶 / 繼續」相關的表述,或直接說明要從歷史延續,例如官方列出的「繼續」「上次」「記住我」「recall memory」等,以落在 Skill 描述的觸發範圍內。
- 預期行爲是:Agent 在首次回覆前先執行記憶召回邏輯,再回答;你應能在首輪迴復中看到對偏好、項目或歷史上下文的引用(具體表現取決於 Agent 是否已持久化 working memory 與 conversation history)。
若環境中沒有可讀的對話歷史或工作記憶,Skill 仍會被觸發,但召回內容可能爲空——這屬於數據側限制,而非 Skill 座標或版本錯誤。
適用場景與注意¶
適合誰
- 長期在同一 Agent 客戶端裏做項目開發,希望每個新 Session 自動帶上用戶偏好與項目上下文。
- 不想在每條新對話開頭手工粘貼「我是誰、項目是什麼、上次做到哪」的說明。
限制與注意
- community 來源:行爲與維護節奏以發佈者
user_ce858ad4與 SkillHub 頁爲準,升級前可用skillhub查看版本(當前 v1.0.1)。 - 依賴 Agent 的記憶基礎設施:簡介要求讀取 working memory 與 conversation history;若客戶端未實現或未開啓相應能力,召回效果會打折扣。
- 新 Session 語義:設計目標是「新對話啓動」;在同一線程裏連續聊多輪,不等同於再次觸發完整的 session-start 流程。
- 無需 API Key:
requires_api_key=false僅表示 Skill 本身不要求 Key;底層模型調用仍受你所用客戶端的賬號與配置約束。
SkillHub 統計(以 api.skillhub.cn 抓取爲準):評分 100000,下載 1568,安裝 21;分類 ai-agent。
結尾¶
「記憶召回」把「開局補上下文」從手工粘貼變成 Session 啓動時的固定步驟:先讀記憶與歷史,再開口回覆。若你正在 SkillHub 上爲 Agent 選配 ai-agent 類能力,可按官方頁安裝 @user_ce858ad4/memory-recall。
- SkillHub 頁面:https://www.skillhub.cn/skills/user_ce858ad4/memory-recall
- API 條目:https://api.skillhub.cn/user_ce858ad4/memory-recall
- 安裝文檔:https://skillhub.cn/install/skillhub.md