bunjang

bunjang

번개장터 CLI 전역 진입점 스킬입니다.

먼저 볼 문서:

• docs/capability-registry.md
• docs/execution-contract.md
• docs/cli-usage.md
• 필요하면 docs/bunjang-assistant.md

이 스킬의 역할:

• 사용자의 자연어 요청을 번개장터 CLI 운영, 시세 조회, 판매글 초안 작성 중 하나로 라우팅합니다.
• 공개 호출 표면은 이 bunjang 하나만 사용합니다.
• 상세 절차는 내부 참조 문서에서 이어서 확인합니다.
• 번개장터툴, 번개장터 도구, 번장툴, bunjang tool, bunjang assistant처럼 짧게 부르면 모두 이 스킬 호출 의도로 해석합니다.
• Claude Code 플러그인 표면의 정식 슬래시 진입점은 /bunjang-assistant:bunjang [작업]입니다. host가 bare command를 따로 노출할 때만 /bunjang [작업]을 보조 진입점으로 취급하고, 그 외 표면에서는 “번장 판매글 작성해줘”, “시세 확인해줘”, “찜했던거 가격 알려줘” 같은 자연어 요청을 직접 처리합니다.

사용자 경험 기준:

• 사용자는 비개발자일 수 있습니다. 먼저 사용자의 업무 문장을 그대로 받아 가능한 작업, 로그인 필요 여부, 수동 확인이 필요한 지점을 짧게 설명하고 직접 진행합니다.
• 정상 흐름에서 사용자에게 터미널 명령, 경로, package manager를 길게 설명하지 않습니다. 그런 정보는 실패 원인을 보고할 때만 짧게 씁니다.
• 사용자가 직접 해야 하는 일은 브라우저 로그인 완료, 판매글 최종 검토, 최종 등록처럼 실제로 대신 할 수 없거나 대신 하면 안 되는 행동만 남깁니다.
• 요청한 기능이 bunjang-cli 또는 이 래퍼에 없으면 꾸며내지 않습니다. 가능한 대체 조회가 있으면 수행하거나 제안합니다.

기본 시작점:

1. 첫 실행은 CLI를 내려받아 준비하느라 수십 초~수 분 걸릴 수 있습니다. 사용자에게 먼저 알리고 진행합니다.
2. 준비 확인은 npx -y --package=github:kimchanhyung98/bunjang-assistant -- bunjang-assistant-run auth.status로 합니다.
3. CLI 작업은 항상 npx -y --package=github:kimchanhyung98/bunjang-assistant -- bunjang-assistant-run <capabilityId> '<paramsJson>'를 사용합니다.
4. src/config.js에 등록되지 않은 원시 bunjang-cli 명령은 직접 조합하지 않습니다.
5. executed, login_required, manual_only 상태를 구분해 보고합니다.

도메인 라우팅:

• 상품 검색, 상세 조회, 채팅, 관심상품, 구매 가능 여부: references/marketplace.md
• “A 상품 시세 알려줘”, “중고가 얼마야”, “판매가 추천”: references/price.md
• “번개장터 판매글 작성해줘”, “상품 폴더로 판매 초안 써줘”, “A 디렉토리의 상품들 판매글 작성해”: references/sales.md
• 브라우저 로그인/판매글 폼 입력: references/browser.md
• 전역 탐색 규칙과 공개/내부 경계: references/routing.md

실행 원칙:

• public read는 로그인 없이 실행합니다.
• 채팅, 관심상품 변경, 구매 가능 여부 확인은 래퍼의 로그인 사전 확인을 따릅니다.
• auth.login, 구매 시작·확정, 최종 판매글 등록, 계정 설정 변경은 수동 전용입니다.
• 판매글 자동화는 되돌릴 수 있는 초안 입력까지만 수행합니다.
• 문서와 src/config.js에 없는 기능, 숨은 파라미터, 관리자 UI 절차는 추정하지 않습니다.

하드 스톱:

• 등록하기를 누르지 않습니다.
• 구매 시작과 최종 확정을 실행하지 않습니다.
• 계정 설정을 변경하지 않습니다.
• 사용자 촬영 사진, 로그인 정보, 계정 정보는 번개장터 판매글 입력 외 제3자 서비스(이미지 호스팅, 외부 분석/OCR API, 클라우드 저장소 등)에 업로드하지 않습니다.
• 고객/클라이언트용 기업 표면, Cursor, Desktop MCP, 호스팅 문서, 다국어 릴리스, 스케줄러를 추가하지 않습니다.

이 스킬은 공개 진입점만 제공합니다. 세부 실행 지침은 모두 references/ 아래 내부 자산으로 유지합니다.