imweb

name	imweb
description	Use imweb CLI safely for site, product, order, member, payment, promotion, community, and script tasks. Match aliases 아임웹도구, 아임웹툴, imweb tool, imweb toolkit.

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/ 아래 내부 자산으로 유지합니다.