参考技能Skill 更新与生命周期

Skill

Skill 更新与生命周期

检查版本、更新发布版本、处理备份，并安全移除本地独立 Skill 运行时。

独立的 Skill 与 CLI 版本

独立 Skill 运行时和 XMemo CLI 是独立的软件包，具有不同的版本号和发布生命周期。更新其中一个不会自动改变另一个。

  • 独立 Skill 软件包：版本 1.1.35 (@xmemo/skill@1.1.35)，可通过 node scripts/xmemo-skill.mjs --version 或 doctor 查看。
  • XMemo CLI 软件包：版本 0.4.x / 1.x (@xmemo/client@0.4.187)，可通过 xmemo --version 查看。
  • 独立更新：通过 npm 更新 @xmemo/client 会更新 CLI 编排器，但在运行 xmemo skill update 之前不会更改现有已安装的 skill 目录。
  • 子资源完整性 (SRI)：CLI 在将文件解压到 agent skill 目录之前，会使用 sha512 SRI 验证软件包 tarball。
# Inspect standalone Skill version:
node scripts/xmemo-skill.mjs --version

# Inspect XMemo CLI version:
xmemo --version

# Inspect detailed runtime health and discovery status:
node scripts/xmemo-skill.mjs doctor

CLI skill 生命周期命令

XMemo CLI 提供了专用命令来检查安装状态、跨 agent 客户端安装、更新到较新版本以及安全移除 skill。

  • 状态：xmemo skill status [--client <id>|--all] [--json] 检查已安装的 skill 并报告版本、客户端 ID 和目标路径。
  • 安装：xmemo skill install [--client <id>|--all] [--project] [--global] [--dir <path>] [--dry-run] [--yes] [--force] [--json]。
  • 更新：xmemo skill update [--client <id>|--all] [--dry-run] [--yes] [--json] 将已安装的 skill 更新到最新的固定版本。
  • 移除：xmemo skill remove --client <id> [--project] [--yes] [--json] 安全移除经过验证的 skill 文件夹。
# Check status across all detected clients:
xmemo skill status --all

# Update an installed skill with preview:
xmemo skill update --client codex --dry-run
xmemo skill update --client codex --yes

# Install to a specific client:
xmemo skill install --client claude-code --yes

现有安装处理、备份与恢复

为防止意外覆盖或丢失自定义设置，安装程序在没有明确确认的情况下拒绝覆盖现有目录，并自动保留备份。

  • 拒绝覆盖：针对现有 skill 目录重新运行 install 会停止并报告现有安装，除非传递了 --force（或 XMEMO_SKILL_FORCE=1）。
  • 自动化备份位置：当 --force 或 skill update 替换安装时，先前的版本将被移动到 ~/.xmemo/backups/skills/<client_id>/<name>-<timestamp>（对于自定义目录为 ~/.xmemo/backups/skills/custom/<basename>-<timestamp>）。
  • 与 agent 加载隔离：备份安全地存放在 ~/.xmemo/backups/ 中，位于 agent 的活动 skills 搜索路径之外，防止重复的工具注册。
  • 恢复：要回滚更新，请将 ~/.xmemo/backups/skills/<client_id>/ 中保留的备份目录恢复到活动 agent skills 文件夹中。
# Force re-install with automatic backup creation:
xmemo skill install --client codex --force --yes

# Inspect preserved backups:
ls -la ~/.xmemo/backups/skills/codex/

移除后保留的内容

移除 skill 是一项解除 skill 目录链接的本地文件系统操作。它不会清除您的凭据、本地配置或远程记忆。

  • 已移除本地 skill 目录：xmemo skill remove 仅删除经过验证的 xmemo-memory 目录并拒绝外部文件夹。
  • 凭据保持完好：~/.xmemo/skill-credentials.json 和环境变量 XMEMO_KEY 保持不变。
  • 配置保持完好：~/.xmemo/ 下的本地设置保持不变。
  • 远程记忆保持完好：xmemo.dev 上存储的记忆、Knowledge 条目和 TODO 不会因 skill 移除而被删除。
  • 完全凭据清理：在移除之前运行 node scripts/xmemo-skill.mjs logout 以撤销活动会话令牌，或手动删除 ~/.xmemo/skill-credentials.json。
  • 记忆清除：远程记忆仍可访问，直到通过 node scripts/xmemo-skill.mjs forget --id <id> --confirm 进行软删除或通过 Memory Console 清除。
# Step 1: Revoke active session credentials (optional):
node scripts/xmemo-skill.mjs logout

# Step 2: Remove the installed skill directory:
xmemo skill remove --client codex --yes

Skill 更新与生命周期

Skill 是不直接挂载托管 MCP 服务器的 Agent 的指令与命令通道。

打开 XMemo Skills

来源: XMemo Skills