前言¶

長期用 Cursor、Claude Code 等帶 Skills 的 Agent 寫代碼時，常見問題是：模型只記得當前會話，你的偏好、反覆踩過的坑、穩定的工作習慣很難跨天延續。項目筆記可以手寫，但和「AI 該怎麼配合你」並不總是一回事。

下面介紹 SkillHub 上的社區 Skill 靈魂存檔（Soul Archive）（座標 @user_dfcfbf47/soul-archive，當前版本 3.2.2）。它把「數字人格持久化」和「主動智能體記憶」放在一起：在日常對話裏積累人格與行爲模式，在會話開始時注入摘要、跨會話召回，並對失敗模式做預警與蒸餾；數據全部落在本機明文 JSON，標籤標明 requires_api_key=false，不依賴額外 API Key。

這是什麼¶

靈魂存檔是發佈者 user_dfcfbf47（SkillHub 頁面標註作者爲「大謙世界」）維護的 ai-agent 類 Skill，來源爲 community。

一句話定位：通過日常 AI 對話構建可延續的「數字靈魂」副本，並配合 Agent 記憶能力，讓後續會話能主動帶上你的人格與歷史上下文，而不是每次從零介紹自己。

核心功能¶

以下能力均來自 SkillHub 官方簡介與頁面說明，可按觸發詞或自動流程使用。

對話生命週期¶

1. 對話開始：主動注入人格摘要（persona injection at session start），讓模型先對齊你的穩定畫像與偏好。
2. 對話進行中：支持跨會話召回（cross-session recall），把此前沉澱的上下文拉回當前任務。
3. 對話結束：默認開啓對話結束自動沉澱（auto_extract 默認爲 ON），在會話收尾時把有價值信息寫入本地檔案，無需每次手動歸檔。

分析與預警¶

• 失敗模式預警（failure-pattern warning）：對重複出現的失敗或低效模式給出提醒，減少同類錯誤反覆發生。
• 模式蒸餾（pattern distillation）：從多輪對話中提煉可複用的行爲模式，便於後續會話引用。

數據與隱私¶

全部數據以本地明文 JSON 存儲，便於備份、遷移或自行審計；不涉及把人格檔案託管到雲端（具體目錄與文件名以安裝後的 SKILL.md 爲準）。

模式與觸發詞¶

官方資料將能力歸納爲日常對話構建克隆體，並列出多類觸發方式。中文側常見表述包括：靈魂沉澱、靈魂存檔、靈魂報告、自我反思等；英文觸發包括 soul extract、soul chat、soul report，以及與會話上下文、記憶召回、自我改進相關的 soul context、soul recall、self-reflect、self-improve 等（在對話中說出或寫入指令即可喚起對應流程，具體行爲以 Skill 內說明爲準）。

與簡介對應的典型能力塊包括：靈魂沉澱（提取）、靈魂對話、靈魂報告、上下文注入、智能體記憶召回、AI 自我改進——本質都是圍繞「沉澱 → 注入 → 召回 → 反思」同一套本地檔案運轉。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓當前 Agent 按 SkillHub 安裝說明 安裝座標 @user_dfcfbf47/soul-archive。

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_dfcfbf47/soul-archive --dir <你的 skills 目錄>

常用路徑（來自 SkillHub 安裝文檔）：

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

安裝後按你所用客戶端的要求重啓或刷新 Skills 列表。Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄位置，安裝命令本身一致。

也可將下面提示直接發給 Agent，由其按安裝文檔完成拉取：

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_dfcfbf47/soul-archive。

典型用法¶

官方未提供獨立腳本示例，用法以「對話 + 觸發詞 + 默認自動沉澱」爲主。可按下面順序理解可復現流程。

1. 安裝並啓用 Skill 後正常與 Agent 協作（寫代碼、評審、排障均可）。保持 auto_extract 默認開啓時，一輪對話結束會自動嘗試沉澱，無需每輪手動執行 soul extract。
2. 新開一輪會話時，Skill 會在對話開始側注入人格摘要；你只需繼續任務，模型應已帶上此前檔案中的穩定信息。
3. 需要顯式操作時，在對話中使用官方列出的觸發詞，例如：
   - 歸檔或提取：soul extract、靈魂沉澱、靈魂提取
   - 基於人格對話：soul chat
   - 生成報告：soul report、靈魂報告
   - 反思與改進：自我反思、self-reflect、self-improve
   - 上下文與記憶：soul context、soul recall
4. 跨會話繼續同一主題時，用召回類觸發或依賴會話開始注入，讓 Agent 讀取本地 JSON 中的歷史模式與備忘。

具體輸出格式、檔案路徑與 hook 細節以安裝包內 SKILL.md 爲準；本文不臆造字段名或目錄結構。

適用場景與注意¶

適合誰

• 長期在同一 Agent 上幹活，希望「你是誰、你怎麼做事、你常犯什麼錯」能跨會話保留的開發者。
• 希望記憶數據留在本機、可自己備份 JSON，又不需要爲 Skill 單獨配置 API Key 的團隊或個人。

限制與注意

• 明文 JSON 便於審計，也意味着本機磁盤權限與備份策略要你自己管好；敏感內容寫入前請自行脫敏。
• 社區 Skill（community），升級與行爲變更以 SkillHub 上 v3.2.2 及後續版本說明爲準。
• SkillHub 統計（截至頁面抓取）：評分 100000，下載 1263，安裝 30；熱度不等於適配你當前的 Agent 版本，安裝後建議用小任務試一輪沉澱與召回是否正常。

結尾¶

靈魂存檔把「人格畫像 + Agent 記憶」從單次聊天裏拆出來，落到本地 JSON，並通過會話開始注入、結束自動沉澱和多種觸發詞，把跨會話協作做成可重複流程。若你要在 Cursor 等環境裏試裝，可從 SkillHub 頁面與 API 入口獲取同一座標：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_dfcfbf47/soul-archive
• 官方地址：https://api.skillhub.cn/user_dfcfbf47/soul-archive