tikeytaka:requires — 플러그인 키 선언 대조

코어 CLI: bash "${CLAUDE_PLUGIN_ROOT}/bin/tkt" (이하 tkt)

tkt requires                      # 설치된 마켓/캐시 플러그인 전체 스캔
tkt requires <플러그인경로> ...    # 특정 경로만

플러그인 루트의 keys.json 선언을 읽어 볼트와 대조한다. 사람이 "이 플러그인엔 무슨 키가 필요하더라"를 기억할 필요를 없앤다.

출력 읽는 법

• ok — 볼트에 있음. 추가 조치 불필요.
• MISSING — 필수인데 미등록. exit code 4.
• opt — 선택 항목 미등록. 그 기능만 비활성일 뿐 정상 동작.

MISSING이 있으면 발급 링크(docs)를 안내하고 add 스킬 절차로 유도한다. 키 값을 채팅으로 받지 않는다 — tkt setp <service>(터미널 숨김 입력)를 사용자가 직접 실행하게 한다.

keys.json 스키마

플러그인 루트(plugin.json과 같은 층)에 둔다. plugin.json에는 넣지 않는다 — Claude Code 매니페스트 스키마에 없는 키를 넣으면 claude plugin validate가 실패한다.

{
  "keys": [
    {
      "service": "gemini-api-key",
      "env": "GEMINI_API_KEY",
      "required": true,
      "description": "이미지 분석 호출용",
      "docs": "https://aistudio.google.com/apikey"
    }
  ]
}

필드	필수	뜻
service	O	볼트 안의 서비스명 (tkt list 출력과 일치해야 함)
env		이 키가 들어갈 환경변수명 — 보고에 표시
required		기본 true. false면 opt로 보고하고 exit code에 영향 없음
description		용도 한 줄
docs		발급 페이지 URL — 미등록일 때 사용자에게 안내됨

주의

• service는 볼트의 실제 이름이다. 새로 짓지 말고 tkt list로 기존 이름을 먼저 확인해 맞춘다 (같은 키가 두 이름으로 갈라지면 전파가 깨진다).
• 이 명령은 읽기 전용이다. 키를 자동 등록하거나 .env를 건드리지 않는다. 전파는 map-add + sync 소관.
• python3가 필요하다 (keys.json 파싱).