Cloud Skills

절차적 메모리 및 스킬 아키텍처

Cloud Skills는 XMemo에서 사용자 작성 절차적 메모리를 제공하여 개발자와 팀이 표준 운영 절차(SOP), 런북, 체크리스트 및 재사용 가능한 프롬프트를 영구 스토리지에 직접 저장할 수 있도록 지원합니다. 저장된 후에는 지원되는 도구 전반의 연결된 에이전트가 에이전트별 설치나 수동 프롬프트 복사 없이 이를 검색, 회상 및 해석할 수 있습니다. 저장된 Cloud Skill은 에이전트 측 연결 브리지 역할을 하는 설치된 XMemo Skill 클라이언트 런타임(@xmemo/skill, node scripts/xmemo-skill.mjs)과 구별됩니다.

• Preview 기능: Cloud Skills는 현재 Memory Console(#skills)에서 Preview로 제공됩니다.
• 식별자 및 자산: 각 스킬은 고유한 skill_id, 읽기 쉬운 슬러그, 이름, 설명, 소유자 범위(Personal 또는 Team) 및 자산 상태(active 또는 archived)를 갖습니다.
• 불변 리비전 체인: 스킬에는 SkillRevision 스냅샷의 추가 전용(append-only) 시퀀스가 포함됩니다. 각 리비전은 revision_id, revision_number, instruction_body, canonical_hash 및 선택적 형식의 SkillComponent 리소스를 전달합니다.
• 크기 제한: 루트 지침 본문은 64 KiB UTF-8로 제한됩니다. 리비전에는 최대 50개의 선언된 컴포넌트가 포함될 수 있으며, 각 컴포넌트는 128 KiB로 제한됩니다.
• 컴포넌트 리소스 유형: 컴포넌트는 reference, example, template, document, artifact 및 script를 포함하는 명시적인 의미 체계 유형을 선언합니다.

게시 라이프사이클 및 팀 검토

Cloud Skill 리비전은 프로덕션 워크플로를 보호하고 협업 작성을 지원하기 위해 구조화된 라이프사이클을 통해 전환됩니다:

• draft: 공개 활성화 전 작성 및 개인 스테이징 중의 초기 리비전 상태입니다.
• proposed: Team 워크스페이스 내에서 작성된 리비전은 proposed 상태로 전환되어 팀 소유자 또는 관리자의 명시적 검토 및 활성화를 기다립니다.
• published: 에이전트 검색 및 기본 레벨 1 회상 대상이 되는 활성 리비전입니다. 특정 시점에 슬러그당 단 하나의 리비전만 published로 지정됩니다.
• deprecated: 오래되었거나 대체된 리비전은 deprecated로 표시하여 일몰을 알리는 동시에 과거의 재현 가능한 회상을 보존할 수 있습니다.
• 개인 대 팀 게시: Personal 워크스페이스에서는 게시 의도로 저장하면 즉시 published로 전환됩니다. Team 워크스페이스에서는 제안된(proposed) 리비전을 통해 검토되지 않은 절차 변경이 에이전트 워크플로를 변경하는 것을 방지합니다.

점진적 회상: Level 0, Level 1, Level 2

연결된 에이전트는 사용되지 않는 문서로 LLM 컨텍스트 창이 포화되는 것을 방지하기 위해 Progressive Recall을 사용하여 필요에 따라 스킬을 회상합니다:

• Level 0 (검색): 쿼리 검색은 전체 지침을 로드하지 않고 사용자 작업과 일치하는 가벼운 설명자(slug, name, description)를 반환합니다.
• Level 1 (루트 회상): 지정된 슬러그에 대한 스킬 루트 지침 및 컴포넌트 매니페스트를 회상하며, 기본적으로 게시된 리비전으로 설정되고 최신 리비전 폴백을 지원합니다.
• Level 2 (리소스 회상): 선언된 단일 컴포넌트(예: 체크리스트 템플릿 또는 참조 스키마)를 회상하며, 호출자가 리소스 분열(resource tearing)을 방지하기 위해 명시적인 revision_id를 제공해야 합니다.

recall_cloud_skill(query="incident response")  # Level 0: lightweight descriptors
recall_cloud_skill(slug="incident-response-checklist")  # Level 1: root instructions + manifest
recall_cloud_skill(
  slug="incident-response-checklist",
  revision_id="<revision-id-from-level-1>",
  resource="templates/triage-template.md",
)  # Level 2: one pinned resource component

리비전 고정으로 리소스 분열 방지

스킬이 업데이트되면 XMemo는 기존 콘텐츠를 덮어쓰는 대신 다음 불변 리비전을 생성합니다. Level 1 루트 회상은 불변 revision_id 및 컴포넌트 매니페스트와 함께 루트 지침을 제공합니다. Level 2 리소스 요청은 호출자가 바로 해당 revision_id를 고정하도록 요구합니다. 에이전트가 워크플로를 실행하는 동안 작성자가 새 리비전을 게시하더라도 에이전트의 고정된 읽기는 처음에 시작된 정확한 스냅샷을 계속 확인하므로 리소스 분열이 제거됩니다.

{
  "kind": "root",
  "data": {
    "skill_id": "skill_inc_triage_01",
    "revision_id": "rev_v1_inc_triage",
    "revision_number": 1,
    "canonical_hash": "c7b14d8e9f2a4c10...",
    "resources": [
      {
        "logical_path": "templates/triage-template.md",
        "type": "template",
        "content_hash": "e3b0c44298fc1c14..."
      }
    ]
  }
}

가져오기, 내보내기 및 작성 인터페이스

개발자는 웹 콘솔에서 대화형으로 Cloud Skills를 작성하거나 표준 배포 패키지에서 기존 스킬을 가져올 수 있습니다:

• 콘솔 작성: 마크다운 편집기 및 컴포넌트 관리를 통해 Memory Console(#skills)에서 대화형으로 스킬을 생성합니다.
• 패키지 가져오기: 표준 SKILL.md 파일(YAML 프론트매터 포함), 다중 파일 ZIP 아카이브 또는 URL(ClawHub 또는 GitHub)을 통한 원격 리포지토리를 가져옵니다.
• 리비전 차이 비교: 단어 수준의 diff를 통해 임의의 두 리비전 간 지침 변경 사항 및 컴포넌트 수정을 비교합니다.
• Source Capsule 내보내기: SKILL.md, 컴포넌트 리소스 및 메타데이터 매니페스트가 포함된 무손실 Source Capsule ZIP 아카이브로 모든 스킬 리비전을 내보냅니다.

에이전트 액세스 프로필 및 샌드박스 격리

권한이 부여된 에이전트는 지원되는 클라이언트 환경에서 계약상 정의된 MCP 도구를 통해 Cloud Skills에 접근합니다:

• 계약된 MCP 도구: recall_cloud_skill(읽기 전용) 및 save_cloud_skill(작성) 도구는 cursor-plugin 및 ordinary-full 클라이언트 프로필(config/mcp-documentation-contract.json)에 계약상 노출되어 있습니다. generic-public, chatgpt-public 또는 claude-code 프로필에는 노출되지 않습니다.
• 프롬프트 실행 절차: 대부분의 Cloud Skills는 코드 실행 없이 프롬프트 안내로 에이전트가 직접 해석하는 표준 운영 절차입니다.
• 샌드박스 실행 경계: execute_cloud_skill을 통한 선택적 백엔드 스크립트 실행은 SandboxExecutionEngine에 의해 제어되는 고급 서버 측 기능입니다(현재 어떤 클라이언트 프로필에도 노출되지 않음). 로컬 bubblewrap 컨테이너 격리가 없는 경우 실행은 SANDBOX_UNAVAILABLE과 함께 fail closed 처리됩니다.

가용성 및 라이프사이클 경계

계정에 절차적 Cloud Skills가 활성화된 경우 Cloud Skill 기능을 사용할 수 있습니다. 리비전은 불변의 콘텐츠 주소 지정 스냅샷이며, 변경 사항을 저장하면 이전 레코드를 덮어쓰지 않고 새 리비전이 생성됩니다. 후보 스킬이 존재하는 경우 콘솔에 명시적인 수동 승격이 필요한 검토 배너가 표시됩니다.