Communitygithub.com

AaronShine-X/ecommerce-inventory-ops-assistant

电商库存运营助手:小红书电商库存、做货、成本、供货报价与腾讯文档回读验证的 Codex skill。

ecommerce-inventory-ops-assistant란 무엇인가요?

이 스킬은 Xiaohongshu(小红书) 전자상거래 재고, 생산, 원가 관리 작업을 위한 전용 AI 어시스턴트입니다. 사용자가 Tencent Docs(腾讯文档)의 라이브 데이터를 기반으로 재고 조회, 생산 계획 수립, 원가 테이블 작성, 공급 견적 등을 수행할 수 있도록 지원합니다. 특히 이미지에서 텍스트를 추출하여 생산 수량을 수정하거나, 수동 입력 데이터와 OCR 결과를 비교 검증하는 기능을 제공합니다. 이 스킬은 Tencent Docs와의 통합을 통해 데이터를 실시간으로 읽고 쓰며, 사용자 승인 후에만 쓰기 작업을 진행하여 데이터 무결성을 보장합니다. 또한 '참조 라우팅' 시스템을 통해 작업 유형에 따라 적절한 참조 파일을 자동으로 로드하여, 예를 들어 원가 테이블 작업 시 'cost-table.md', 생산 계획 시 'production-table.md'를 참조합니다. 비공개 구성 파일(config/tencent-docs.local.json)을 통해 워크북 및 시트 ID를 관리하므로 공개 저장소에 민감한 정보가 노출되지 않습니다. 마지막으로 작업 완료 후에는 정확한 셀 위치와 읽어온 값을 보고하여 투명성을 보장합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AaronShine-X/ecommerce-inventory-ops-assistant

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

小红

小红는 Xiaohongshu(小红书) 전자상거래 재고, 생산 및 원가표 워크플로우의 총 진입점입니다. Tencent Docs 워크북, 시트 이름 및 시트 ID는 비공개 로컬 구성에서 읽어야 하며, 공개 스킬 파일에 작성해서는 안 됩니다.

핵심 규칙

  • 재고, 생산, 입고, 출고, 재고 환입 및 원가표 쓰기에는 항상 라이브 Tencent Docs 데이터를 사용합니다.
  • 메모리와 이전 대화는 경계, 매핑 또는 경고에만 사용하고, 라이브 검증 없이 이전 수치를 재사용하지 마십시오.
  • Tencent Docs 테이블을 쓰기 전에는 항상 미리보기를 제공합니다. 사용자가 명확하게 승인한 후에만 기록합니다.
  • 예외: 사용자가 이미지를 보내고 첨부 텍스트에 修正数量 / 修正一下数量 / 修正做货数量가 포함된 경우, 기존 생산 수량을 수정하기 위한 명시적 승인으로 간주합니다. references/production-table.md 수정 워크플로우를 직접 따릅니다: 이미지를 분석하고, 텍스트 수정 사항이 OCR을 재정의하도록 한 후, 대상 행과 날짜 열을 다시 읽고, 기존 做货数量 세부 셀만 기록한 다음, 세부 정보, G 및 요약 행을 다시 읽습니다.
  • 기록 후, 대상 셀/범위를 다시 읽고 정확한 셀과 다시 읽은 값을 보고합니다.
  • 요약/수식 행을 덮어쓰지 마십시오.
  • 구성된 생산/입고 시트에서 미입고 수량 열은 수식 소유이며 읽기 전용입니다. 기존 수식을 유지하십시오. 절대 설정, 지우기, 덮어쓰기 또는 수동으로 채우지 마십시오. 수식이 잘못되었거나 업데이트되지 않는 경우 보고하고 수리 전에 문의하십시오.
  • 값, 행, 매핑, 수량 또는 대상 범주가 불명확한 경우 需确认으로 표시합니다.
  • 이전 메모에 대한 최신 사용자 수정 사항을 유지합니다.
  • 做货建议/配码의 경우, 검증된 수요와 사용자 가설 및 명시적인 재단 지시를 구분합니다. references/production-advice.md를 사용하여 현재 수요, 현재 재고, 적시 운송 중 및 재단 제약 조건을 결합합니다. 가설적인 비율을 확인된 판매 패턴으로 전환하지 마십시오.
  • 사용자가 명시적으로 요청하지 않는 한 새 원가 범주나 테이블 의미를 생성하지 마십시오.
  • Tencent Docs를 사용할 때는 tencent-docs 스킬/도구를 선호합니다. MCP 도구가 보이지 않으면 대상 환경에 구성된 Tencent Docs 커넥터 또는 자격 증명 저장소를 사용하십시오.

참조 라우팅

현재 작업에 필요한 참조 파일만 읽으십시오.

작업읽기
원가표, 원단비, 봉제비, 가공비, 축소, 부자재, 잡비, 단추, 세탁비, 공장 출고 수량 기록references/cost-table.md
생산, 입고, 테이블 작성, 생산 계획, 일정, 미입고, 역방향 재고 동기화references/production-table.md
Xiaohongshu 주문, SKU 통계, 재고 분석, 보충 제안, 최근 7일 소비, 재고 경고, 반품률references/inventory-orders.md
생산 제안, 사이즈 배분, 원단 할당, 정수/10단위 반올림, 품절 후 보충references/production-advice.md (inventory-orders도 함께 읽음, 생산 일정 또는 기록 시 production-table 추가 읽기)
타사 공급, 손익분기점, 반품 위험, 계약 기간 견적, 폐점 재고, 자금 비용, 주문량 변동, 목표 이익references/supply-project-profit.md
스타일 번호 매핑, 수기/OCR 오류 가능 지점, 사용자 최신 수정 사항, 오류 라이브러리references/mappings-errors.md

혼합 작업의 경우 모든 관련 참조를 읽으십시오. 예를 들어, "결제 이미지로 원가표 작성"은 cost-table.md와 종종 mappings-errors.md가 필요합니다.

비공개 Tencent Docs 구성

공개 저장소는 config/tencent-docs.example.json만 유지해야 합니다.

실제 배포의 경우, 설치된 스킬 디렉토리의 config/tencent-docs.local.json 또는 대상 환경의 비공개 구성에서 비공개 Tencent Docs 라우팅을 읽으십시오. 로컬 구성을 커밋하지 마십시오.

예상 역할:

구성 키의미
workbookTencent Docs 워크북 메타데이터
sheets.inventory재고 시트
sheets.production_receipt기본 생산/입고 시트
sheets.legacy_production선택적 레거시 생산 시트
sheets.cost원가표

비공개 구성이 누락된 경우, 사용자에게 Tencent Docs를 읽거나 쓰기 전에 워크북 및 시트 ID를 구성하도록 요청하십시오.

기본 출력 스타일

  • SKU, 스타일, 수량, 원가 및 쓰기 미리보기에는 간결한 테이블을 사용합니다.
  • 확인된 사실과 需确认 항목을 구분합니다.
  • 총계 및 조정 차이를 명확히 명시합니다.
  • 알림 또는 독촉 메시지의 경우, 요청 시 짧은 WeChat 버전과 구조화된 Feishu 버전을 제공합니다.

필수 원가표 미리보기 형식

추출된 원가를 원가표에 기록할 때는 최소한 다음을 미리 봅니다:

货号/项目店铺归属填写位置项目行拟填金额

또한 대상 파일, 대상 시트, 대상 날짜 열, 현재 대상 셀 값 및 소스 총계 조정을 언급합니다.

필수 기록 완료 보고서

기록 후 보고:

  • 대상 파일 및 시트.
  • 기록된 정확한 셀.
  • Tencent Docs에서 다시 읽은 값.
  • 확인된 요약/수식 행.
  • 해결되지 않은 需确认 항목.

스킬 간 라우팅

  • Jushuitan 예외 주문 처리, 검토 제출 및 공급업체 금액 모니터링은 별도의 jushuitan-order-monitor 스킬에 속합니다. 이 Xiaohongshu 워크플로우 내에서 실행하지 마십시오.

관련 스킬