Workspace 제품 플러그인

workspace 0.8.0는 현재 상태·관련 자료·기록 원문을 근거로 다음 업무를 준비하는 제품 스킬의 소스 후보다. Claude Code와 Codex가 같은 skills/workspace/를 사용하며 개발 스킬은 포함하지 않는다. 기존 운영 MCP https://ayzcluvdppsppwszzaqx.supabase.co/functions/v1/mcp에 연결하며 OAuth 로그인이 필요하다. 새 앱에서 이 패키지를 재사용할 때는 두 MCP 설정의 주소를 해당 앱의 검증한 주소로 함께 바꾼다. 토큰이나 서버 비밀을 파일에 넣지 않는다. 후보 소스 변경은 기존 설치 갱신이나 운영 서버 배포를 뜻하지 않는다.

0.6.1은 모든 업무 쓰기에 UUID request_key를 요구하며 같은 논리 요청의 불확실한 재시도에는 정확한 입력과 키를 유지한다. 공개 ID 사전 발급은 없고 준비는 읽기이며 생성 성공 응답의 정본 ID를 사용한다. 키/입력을 잃거나 결과가 만료되면 현재 상태와 다음 의도를 확인하고 새 키로 자동 반복하지 않는다. get_status로 현재 현황을, list_indexing_issues로 최대 5개 문제 기록의 이유·전송 시도 수·본문 구간 진행을 확인한다. 응답 확인 불가는 확정 실패가 아니다. 이전 키 없는 클라이언트와의 쓰기 호환은 제공하지 않는다.

0.7.0에서 도입한 계약은 자료 종류·발급처·문자열 번호를 결합한 불변 자료 식별자와 재사용 발급처·번호 규칙, 종류별 식별 설정 도구를 사용한다. 생성 시 종류별 설정을 확인하고 identity_version을 유지하며 일반 수정으로 번호를 바꾸지 않는다. 전역 entity_identity 설정과 rekey 입력은 제거한다. 서버를 먼저 같은 revision으로 배포·검증한 뒤 클라이언트를 갱신해야 한다. 소스·운영 서버·설치된 클라이언트의 실제 적용 상태는 해당 릴리스 이슈에서 확인한다. 종류별 식별 결정의 빈 저장소 전환 범위를 따른다.

“준비만” 요청은 원문 식별자와 가능한 순서·필요한 확인을 제안한 뒤 끝낸다. 자료 충돌, 검색 장애와 색인 지연을 구분한다. 다중 대상·메모·관련 자료의 서버 계약을 안내하고 과거 캡처의 해석은 skills/workspace/references/preservation.md를 필요한 경우에만 읽는다. 실제 클라이언트 검증 절차와 원시 출력 없는 증거 범위는 행동 실험에 있다.

0.6.1은 할 일 종류별 입력 조건, 오래 갱신되지 않은 색인 준비 상태의 해석, 신규 변경 메모와 과거 캡처의 차이, 앱 오류와 연결 계층 오류의 구분을 안내한다. 기존 사건/캡처나 업무 저장 규칙은 변경하지 않는다.

0.6.3는 반복 업무의 ISO 요일 번호, 해당 달에 없는 날짜의 월말 보정과 회차 중복 제거, 할 일 시간대 기준 오늘까지 가능한 결과 기록을 안내한다. 날짜 계산·저장 정책은 그대로 유지한다.

설치와 업데이트

통합 소스 후보는 자료 종류·현재/과거 단일 스키마 문서 조회와 properties 기반 생성·부분 수정·상세 계약을 안내한다. 종류 메타데이터와 속성 표시 annotation은 같은 문서에 있고 이름·아이콘·보관 변경도 새 스키마 버전으로 게시한다. 같은 종류의 스키마와 전체 값을 확인한 뒤 저장하며, 스키마 충돌에서는 초안을 유지하고 정본을 검토한다. 이 소스 변경은 기존 설치 갱신이나 운영 서버 배포를 뜻하지 않는다. 0.8.0은 단일 JSON Schema·가져오기/내보내기와 원칙 기능 제거를 반영한 릴리스 패키지다. 두 manifest의 버전을 함께 유지하며 운영 적용과 계정 패키지·설치 갱신의 실제 결과는 릴리스 #475에 기록한다.

제품 스킬 정본은 이 저장소의 plugins/workspace/다. plugin-creator:update-plugin 스킬로 설치 대상의 소유 원본과 갱신 경로를 구분한다. 로컬/Git marketplace 설치는 아래 CLI 갱신/재설치를 사용하며 설치 cache를 직접 편집하지 않는다. ChatGPT 계정 패키지는 현재 원본·정확한 backend plugin ID·release·편집 가능 scope를 조회하고 도구로 갱신한다. 웹·모바일 배포나 스킬만 보이는 문제는 MCP 앱 연결 절차를 먼저 따른다. 서버 배포·앱 등록·패키지 업로드·실제 호출의 완료 여부를 각각 확인한다.

앞으로 웹/앱 UI에서 플러그인을 설치·갱신·게시하지 않는다. 대상의 도구·CLI가 지원하지 않으면 미지원/미검증으로 기록하고 UI로 대신하지 않는다. 과거 Claude 웹 설치·사용 검증은 당시 이력이며 이 새 배포 경로의 검증을 뜻하지 않는다.

저장소 루트에서 Claude Code:

claude plugin validate ./plugins/workspace
claude plugin validate .
claude plugin marketplace add ./
claude plugin install workspace@workspace-template
claude plugin details workspace@workspace-template

새 세션에서 /workspace:workspace를 선택하고 MCP OAuth 로그인을 완료한다. 로컬/Git marketplace 원본의 버전을 올린 뒤 claude plugin marketplace update workspace-template와 claude plugin update workspace@workspace-template를 실행하고 새 세션 또는 /reload-plugins에서 반영한다. Claude Code 2.1.140의 격리 홈에서 로컬 0.1.0→0.1.1 업데이트를 확인했다.

Codex CLI:

codex plugin marketplace add .
codex plugin add workspace@workspace-template
codex plugin list --json

Codex 설치·갱신은 아래 CLI 지원 경로를 사용한다. desktop에서 CLI 설치가 실제 반영되는지와 스킬 선택·OAuth·업무 수행은 별도 확인하며, 미확인 상태에서 desktop까지 갱신됐다고 표시하지 않는다. 패키지와 서버의 호환성을 먼저 검사하고 실제 제품 릴리스에서 두 manifest의 버전을 함께 올린다.

위 로컬 경로 marketplace는 원본을 수정한 뒤 codex plugin add workspace@workspace-template --json을 다시 실행하면 새 버전의 cache로 설치된다. codex plugin list --json으로 버전·enabled를 확인하고 새 세션에서 다시 사용한다. Codex CLI 0.147.0의 격리 설정에서 0.1.0→0.1.1 재설치를 확인했다.

Git source로 등록한 marketplace만 codex plugin marketplace upgrade workspace-template로 원격 snapshot을 갱신한 뒤 같은 plugin add를 실행한다. 로컬 source에서 marketplace upgrade는 not configured as a Git marketplace로 실패한다.

검사와 보관

node scripts/check-plugin.mjs
node --test scripts/check-plugin.test.mjs
node scripts/package-plugin.mjs C:/release-artifacts/workspace-0.8.0.zip

명령은 저장소 루트에서 실행한다. ZIP과 옆의 .json 증거는 저장소 밖에 쓴다. 파일 순서·ZIP 시각을 고정해 같은 원본은 같은 SHA-256을 만든다. 증거에 버전, endpoint, 도구 목록, 서버 도구 원본 해시와 각 패키지 파일 해시가 들어간다. 서버 원본의 해시는 실제 운영 revision 확인을 대신하지 않는다. 운영에서 아직 배포하지 않은 도구는 연결된 서버에서 사용할 수 없다.

복구는 보관한 이전 ZIP을 추출하고 같은 marketplace 식별자의 원본을 교체한 뒤 지원되는 갱신·재설치 절차를 따른다. 서버를 함께 롤백하지 않으며 현재 서버와의 호환성을 다시 확인한다.

실클라이언트 검증은 신규 설치와 업데이트 각각에서 OAuth, 도구 발견·호출, 스킬 선택, 검색→원문→요청된 저장을 확인한다. 자동 패키지 검사는 이 행동을 대신하지 않는다. 패키지 검사와 제품 행동 검증 도구를 제공하며 결과는 관련 GitHub 이슈·PR에서 확인한다. claude.ai·Desktop·모바일의 실제 행동은 별도로 검증한다. Codex desktop 잔여 확인 #102은 다른 클라이언트 결과로 대체하지 않는다. 0.1.1은 Entity 후보의 31개 도구 안내를 포함한다. 운영에 해당 revision을 배포했다는 의미는 아니다.

공식 형식과 명령(2026-10-04 확인): Codex 패키징, Claude manifest, Claude marketplace.

JSON Schema 내보내기는 get_entity_schema의 schema 문서를 사용한다. 가져오기는 preview_entity_schema_import로 원문·버전·차이·키 대응을 검토하고 prepare_entity_schema_import로 기존 종류 변경안 또는 명시적인 새 종류 복사를 준비한다. 웹의 파일·텍스트 입력도 같은 파서와 검증을 사용한다.