前言¶

长期用 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