참조스킬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는 파일을 에이전트 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는 설치 상태를 점검하고, 에이전트 클라이언트 전반에 설치하며, 최신 릴리스로 업데이트하고, 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>)로 이동됩니다.
  • 에이전트 로딩으로부터의 격리: 백업은 에이전트의 활성 skill 검색 경로 외부인 ~/.xmemo/backups/에 안전하게 보관되어 중복 도구 등록을 방지합니다.
  • 복구: 업데이트를 롤백하려면 보존된 백업 디렉터리를 ~/.xmemo/backups/skills/<client_id>/에서 활성 에이전트 skill 폴더로 다시 복원하십시오.
# 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 서버를 직접 마운트하지 않는 에이전트를 위한 지침 및 명령 경로입니다.

XMemo Skills 열기

출처: XMemo Skills