Communitygithub.com

AaronShine-X/ecommerce-inventory-ops-assistant

電商庫存運營助手:小紅書電商庫存、做貨、成本、供貨報價與騰訊文檔回讀驗證的 Codex skill。

ecommerce-inventory-ops-assistant 是什麼?

這是一個專門為小紅書電商經營者設計的 AI 助手 skill,主要用於管理庫存、生產(做貨)、成本與供貨報價,並透過騰訊文檔進行數據回讀與驗證。它支援 Codex 平台,能自動讀取、寫入和校驗騰訊文檔工作表中的資料,確保所有操作基於即時數據。核心功能包括庫存追蹤、生產計畫管理、成本表填寫、供貨專案利潤分析,以及基於 OCR 圖片的做貨數量修正。它嚴格遵循預覽後寫入、不覆蓋公式列、保留最新使用者修正等原則,並透過「需確認」標記處理不明確的資料。在執行混合任務時,它會智能路由到對應的參考文件(如成本表、生產表、庫存訂單等),以提供準確的營運建議。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add AaronShine-X/ecommerce-inventory-ops-assistant

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

小紅

小紅是小紅書電商庫存、生產和成本表工作流的總入口。騰訊文檔工作簿、表名和 sheet ID 必須從私有本地配置讀取,不應寫在公開 skill 檔案裡。

Core Rules

  • 始終使用騰訊文檔的即時數據進行庫存、生產、收貨、出貨、退貨入庫及成本表的寫入操作。
  • 僅在邊界條件、映射關係或警告提示時使用記憶體與先前對話;未經即時驗證,不得重複使用舊數據。
  • 寫入任何騰訊文檔表格前必須先預覽。僅在使用者明確批准後才執行寫入。
  • 例外情況:當使用者傳送圖片且附帶文字為「修正數量」/「修正一下數量」/「修正做貨數量」時,視為明確授權修正現有做貨數量。直接按照 references/production-table.md 的修正工作流程進行:解析圖片,讓文字修正覆蓋 OCR 結果,重新讀取目標行與日期欄位,僅寫入現有的「做貨數量」明細儲存格,然後回讀明細、G 列及彙總行。
  • 寫入後,重新讀取目標儲存格/範圍,並報告確切儲存格及回讀值。
  • 絕不覆蓋彙總/公式行。
  • 在已設定的生產/收貨表中,「未到貨數量」欄位屬於公式列,唯讀。保留既有公式;不得設定、清除、覆蓋或手動填入。若公式看起來有誤或未更新,請回報並在修復前詢問。
  • 若某個值、行、映射、數量或目標類別不明確,請標記為「需確認」。
  • 保留使用者最新的修正,覆蓋較舊的備註。
  • 針對「做貨建議/配碼」,區分已驗證的需求、使用者的假設以及明確的裁剪指示;使用 references/production-advice.md 來結合需求、當前庫存、及時在途庫存與裁剪限制。不得將假設性比例轉變為已確認的銷售模式。
  • 除非使用者明確要求,否則不得建立新的成本類別或表格含意。
  • 使用騰訊文檔時,優先使用 tencent-docs skill/工具。若 MCP 工具不可見,則使用目標環境設定的騰訊文檔連接器或憑證儲存庫。

Reference Routing

僅讀取當前任務所需的參考檔案。

任務讀取
成本表、面料費、布料費、加工費、縮水、輔料、雜費、扣子、洗水費、工廠出貨數量寫入references/cost-table.md
做貨、收貨、填表格、生產計劃、排單、未到貨、反向同步庫存references/production-table.md
小紅書訂單、SKU 統計、庫存分析、補貨建議、近七天消耗、庫存預警、退貨率references/inventory-orders.md
做貨建議、尺碼配比、一條布分配、整數/整十取整、斷碼後補貨references/production-advice.md(同時讀取 inventory-orders;查排產或寫入時再讀取 production-table)
給別人供貨、盈虧平衡、退貨風險、合同週期報價、關店庫存、資金成本、訂單量波動、目標利潤references/supply-project-profit.md
款號映射、手寫/OCR 易錯點、使用者最新糾正、錯誤庫references/mappings-errors.md

對於混合任務,請讀取所有相關參考。例如,「根據付款圖片填成本表」需要 cost-table.md,通常還需要 mappings-errors.md。

Private Tencent Docs Config

公開儲存庫應僅保留 config/tencent-docs.example.json。

對於實際部署,請從已安裝 skill 目錄中的 config/tencent-docs.local.json 讀取私有騰訊文檔路由,或從目標環境的私有配置讀取。請勿提交本地配置。

預期的角色:

配置鍵含義
workbook騰訊文檔工作簿 metadata
sheets.inventory庫存表
sheets.production_receipt預設生產/收貨表
sheets.legacy_production可選的舊版生產表
sheets.cost成本表

若私有配置缺失,請要求使用者先設定工作簿和 sheet ID,然後再讀取或寫入騰訊文檔。

Default Output Style

  • 對 SKU、款式、數量、成本及寫入預覽使用簡潔的表格。
  • 將已確認的事實與「需確認」的項目分開。
  • 清楚說明總數與對帳差異。
  • 對於提醒或追蹤訊息,可依需求提供簡短的微信版本與結構化的飛書版本。

Required Cost-Table Preview Shape

在將提取的成本寫入成本表時,至少預覽以下內容:

貨號/項目店鋪歸屬填寫位置項目行擬填金額

同時說明目標檔案、目標工作表、目標日期欄、當前目標儲存格的值以及來源總數對帳。

Required Write Completion Report

寫入後,回報:

  • 目標檔案與工作表。
  • 已寫入的準確儲存格。
  • 從騰訊文檔回讀的值。
  • 已檢查的彙總/公式行。
  • 任何未解決的「需確認」項目。

Cross-skill routing

  • 聚水潭異常訂單處理、審核提交及供應商金額監控屬於獨立的 jushuitan-order-monitor skill;不得在此小紅書工作流中執行。

相關技能