imweb

imweb

아임웹 CLI 전역 진입점 skill입니다.

먼저 볼 문서:

• docs/capability-registry.md
• docs/execution-contract.md
• docs/commands.md
• 필요하면 docs/imweb-ai-toolkit.md

이 skill의 역할:

• 현재 profile, site_code, 인증 상태와 지원 커맨드 범위를 먼저 확인합니다.
• 요청을 정확한 도메인으로 라우팅하고, 상세 절차는 내부 reference에서만 이어서 확인합니다.
• 공개 호출 표면은 이 imweb 하나만 사용합니다.
• 사용자가 아임웹도구, 아임웹 도구, 아임웹툴, imweb tool, imweb tools, imweb toolkit처럼 짧게 부르면 모두 이 skill 호출 의도로 해석합니다.

사용자 경험 기준:

• 사용자는 비개발자일 수 있습니다. 먼저 사용자의 업무 문장을 그대로 받아서 가능한 작업, 필요한 승인, 로그인 필요 여부를 짧게 설명하고 직접 진행합니다.
• 정상 흐름에서 사용자에게 터미널 명령, 설정 파일, 경로, 환경 변수, package manager를 설명하지 않습니다. 그런 정보는 실패 원인을 보고할 때만 짧게 씁니다.
• 사용자가 직접 해야 하는 일은 버튼 클릭, 브라우저 로그인 완료, 권한 허용처럼 실제로 대신 할 수 없는 행동만 남깁니다.
• 설치나 초기화가 필요해도 "어떻게 진행할까요?"처럼 선택지를 묻지 않습니다. 허용된 read-only 확인과 공식 설치 경로는 먼저 직접 실행하고, 실패했을 때만 원인과 사용자가 해야 할 한 가지 행동을 말합니다.
• 요청한 지표나 분석 축이 CLI에 없으면 꾸며내지 않습니다. "현재 CLI에는 방문자/트래픽별 상품 순위가 없습니다"처럼 한계를 말하고, 가능한 대체 조회(예: 상품 목록/상품 상세/주문 기반 점검)를 제안하거나 수행합니다.

기본 시작점:

1. Claude Desktop Cowork 또는 Claude plugin에서 imweb_cli_check, imweb_auth_status, imweb_auth_login, imweb_context, imweb_command_capabilities, imweb_order_list, imweb_order_get, imweb_site_info, imweb_product_list, imweb_product_get, imweb_member_list 같은 MCP tools가 보이면 이것을 먼저 사용합니다.
2. MCP tool이 있으면 VM shell에 CLI를 설치하거나 VM 안에서 auth를 만들지 않습니다. host CLI/auth를 쓰는 MCP tool로만 진행합니다.
3. MCP tool이 있고 host imweb CLI가 없으면 사용자에게 설치 명령을 쓰게 하지 말고 imweb_cli_install을 호출합니다. Claude Desktop이 권한을 물으면 사용자는 이 작업에 허용 / Allow for this task만 누르면 됩니다.
4. Claude Desktop Cowork에서 MCP tool이 보이지 않으면 VM 안에 CLI를 먼저 설치하지 않습니다. Shell/Bash 도구는 imweb MCP tool이 아닙니다. 대신 npx -y github:imwebme/imweb-ai-toolkit --tool claude-cowork로 imweb-ai-toolkit.plugin과 imweb.skill을 만들고, Cowork host가 설치 카드로 받을 수 있게 두 artifact를 제시합니다. 실제 사용자 데이터 조회는 host imweb MCP tool이 보일 때만 진행합니다.
5. Claude Code, Codex, 또는 일반 sandbox처럼 Cowork host plugin 설치 카드가 없는 환경에서만 현재 런타임의 command -v imweb와 imweb --version을 확인합니다.
6. 현재 런타임 안에 CLI가 없고 MCP bridge도 없으면 공식 공개 설치 경로로 CLI를 설치합니다: npx -y github:imwebme/imweb-ai-toolkit --tool cli. 설치가 끝나면 바로 auth/context 확인으로 이어갑니다.
7. imweb_context 또는 imweb --output json config context
8. imweb_command_capabilities 또는 imweb --output json config command-capabilities
9. 필요한 경우 domain/path 범위로 command-capability를 좁힙니다.
10. 필요한 하위 명령만 --help

/imweb만 호출되고 업무 문장이 없을 때:

• MCP tool 또는 CLI 준비 상태를 확인합니다.
• Claude Desktop Cowork에서 MCP tool이 없으면 plugin/skill package를 생성해 설치 카드로 제시합니다. Cowork 시작 입력에서 /imweb가 거절되면 앱 라우팅 제한이므로, 설치 뒤에는 아임웹툴로 최근 주문중 이상 거래 조사해줘.처럼 자연어로 다시 시작합니다.
• MCP tool이 있고 host CLI가 없으면 imweb_cli_install을 호출합니다.
• 일반 sandbox에서 CLI가 없으면 공식 CLI 설치를 먼저 시도합니다.
• 준비가 끝나면 "주문 조회, 상품 점검, 회원 조회처럼 요청을 말해 주세요" 정도로만 짧게 말합니다.
• "플러그인 설치 / 터미널 직접 실행 / 원하는 작업 말하기" 같은 선택지 목록으로 끝내지 않습니다.

로그인 온보딩:

• auth/token이 없거나 만료되어 있으면 먼저 imweb_auth_status와 imweb_auth_doctor로 상태를 확인합니다.
• Claude Desktop이 imweb MCP tool 권한을 묻는 화면을 보여주면, 사용자는 이 작업에 허용 / Allow for this task 버튼만 누르면 된다고 짧게 안내합니다.
• 로그인이 필요하면 사용자를 터미널로 보내지 말고 imweb_auth_login MCP tool을 호출합니다. 브라우저가 열리면 사용자가 로그인 버튼과 계정 확인만 누르면 된다고 짧게 안내합니다.
• MCP tool이 없고 sandbox/VM 안 CLI를 직접 쓰는 경우에는 imweb --output json auth status, imweb --output json auth doctor, imweb --output json auth login 순서로 처리합니다. 브라우저가 열리면 사용자는 브라우저 로그인만 완료하면 된다고 말합니다.
• imweb_auth_login이 끝나면 imweb_auth_status 또는 imweb_context를 다시 호출한 뒤 원래 요청을 이어서 실행합니다.
• 로그인 뒤에도 profile, site_code, scope가 비어 있으면 무엇이 부족한지만 구체적으로 말하고, 추정으로 API를 호출하지 않습니다.
• sandbox/VM에서 브라우저 로그인을 시작할 수 없으면 원래 요청을 보류한 채, 사용자가 해야 하는 브라우저 로그인 또는 권한 허용 한 가지 행동만 안내합니다. 터미널 복붙이나 package manager 선택으로 보내지 않습니다.

CLI/런타임 게이트:

• npm registry의 imweb package는 공식 아임웹 CLI가 아니므로 조회하거나 설치하지 않습니다.
• Claude Desktop Cowork에서는 plugin이 제공하는 local MCP bridge가 사용자 컴퓨터의 공식 CLI와 인증 상태를 재사용합니다. MCP tool이 있으면 VM shell에 CLI를 새로 설치하려고 하지 않습니다.
• imweb_cli_install MCP tool은 host CLI가 없거나 오래된 경우의 기본 설치/업데이트 경로입니다. Claude Desktop의 tool permission prompt가 사용자의 설치 승인 지점입니다.
• Claude Desktop Cowork의 작업 shell은 사용자 Mac이 아니라 별도 Linux 런타임일 수 있습니다. uname -s && uname -m으로 현재 실행 환경을 확인합니다.
• Cowork에서 MCP tool이 없으면 runtime CLI 설치로 우회하지 말고 plugin package 생성/제시 흐름을 먼저 수행합니다. host 연결 없이 VM CLI를 설치해도 사용자의 Mac 인증 상태를 검증한 것이 아닙니다.
• MCP tool과 CLI가 모두 없다는 사실만으로 "직접 작업이 어렵다"고 결론내리지 않습니다. Cowork에서는 plugin package를 제시하고 host imweb tool이 아직 연결되지 않았다고 말합니다. 일반 sandbox에서는 공식 CLI 설치를 시도한 뒤 실패한 경우에만 실패 원인을 근거로 보고합니다.
• auth/profile이 없으면 먼저 MCP 기반 로그인 도구 또는 CLI auth login을 사용하고, 컴퓨터유즈나 사용자 터미널 실행으로 우회하지 않습니다.
• 사용자가 명시적으로 로컬 앱 조작을 요청하지 않았다면 Terminal, Customize, Settings, computer-use를 요청하지 않습니다.

도메인 라우팅:

• 주문, 취소, 반품, 교환, 송장, 배송: references/order.md
• 무통장 입금 확인: references/payment.md
• 상품, 카테고리, 재고, 옵션, 이미지: references/product.md
• 회원 조회, 등급, 그룹, 카트, 위시리스트: references/member.md
• 쿠폰, 포인트: references/promotion.md
• Q&A, 리뷰, 리뷰 답변: references/community.md
• 사이트 정보, 유닛, integration: references/site.md
• 스크립트 조회/변경: references/script.md
• 전역 탐색 규칙과 공개/내부 경계: references/routing.md

실행 원칙:

• 커맨드군을 문서에 복제하지 말고 registry의 domain, surface, public_leaf_paths를 먼저 봅니다.
• write 전에는 가능한 read로 현재 상태와 대상 식별자를 먼저 확인합니다.
• write는 항상 --dry-run으로 요청 형태를 먼저 확인합니다.
• 대상, 입력 JSON, 변경 의도가 확정된 뒤에만 --yes를 사용합니다.
• 문서와 --help에 없는 workflow, 숨은 파라미터, 관리자 UI 절차는 추정하지 않습니다.
• imweb이 없을 때 npm install -g imweb, npm info imweb, npx imweb 같은 npm package-manager 경로를 사용하지 않습니다.
• 단일 관찰이나 단일 live 검증 사례를 모든 환경의 일반 규칙처럼 확장하지 않습니다.
• 실패 사례와 성공 사례의 차이가 보여도, 그 한 건만으로 실패 원인을 단정하지 않습니다.

이 skill은 공개 진입점만 제공합니다. 세부 도메인 playbook은 모두 references/ 아래 내부 자산으로 유지합니다.