Communitygithub.com

AaronShine-X/ecommerce-inventory-ops-assistant

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

Was ist ecommerce-inventory-ops-assistant?

Dieser Skill, genannt „小红“ (Xiaohong), dient als zentraler Workflow-Einstieg für die Bestands-, Produktions- und Kostenverwaltung von Xiaohongshu (小红书) E-Commerce-Betrieben. Er ermöglicht das Auslesen und Schreiben von Echtzeitdaten in Tencent Docs (腾讯文档) für Bestand, Produktion, Wareneingang, Warenausgang, Retouren und Kostentabellen. Der Skill stellt sicher, dass vor jedem Schreibvorgang eine Vorschau angezeigt und die explizite Zustimmung des Benutzers eingeholt wird, außer bei Bildkorrekturen mit bestimmten Schlüsselwörtern. Er unterstützt verschiedene Referenzdateien für spezifische Aufgaben wie Kostentabellen, Produktionsplanung, Bestandsanalyse und Lieferprojektkalkulation. Die private Konfiguration für Tencent Docs (Workbook- und Sheet-IDs) muss aus lokalen oder umgebungsspezifischen Config-Dateien gelesen werden, um Sicherheits- und Anpassungsanforderungen zu erfüllen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add AaronShine-X/ecommerce-inventory-ops-assistant

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

小红

小红是小红书电商库存、生产和成本表工作流的总入口。腾讯文档工作簿、表名和 sheet ID 必须从私有本地配置读取,不应写在公开 skill 文件里。

核心规则

  • 始终使用腾讯文档的实时数据进行库存、生产、入库、出库、退货入库和成本表写入。
  • 仅在边界、映射或警告时使用记忆和之前的对话;未经实时验证不得重复使用旧数据。
  • 在写入任何腾讯文档表之前,先预览。只有在用户明确批准后才写入。
  • 例外情况:当用户发送图片并且随附文本包含 修正数量 / 修正一下数量 / 修正做货数量 时,视为明确批准修正现有生产数量。直接遵循 references/production-table.md 中的修正工作流:解析图片,让文本修正覆盖 OCR,重新读取目标行和日期列,仅写入现有的 做货数量 明细单元格,然后重新读取明细、G 列和汇总行。
  • 写入后,重新读取目标单元格/范围,并报告确切的单元格及其回读值。
  • 绝不要覆盖汇总/公式行。
  • 在配置的生产/入库表中,未收货数量列由公式拥有且为只读。保留现有公式;绝不设置、清除、覆盖或手动填充。如果公式看起来错误或未更新,报告它并在修复前征求许可。
  • 如果某个值、行、映射、数量或目标类别不清楚,标记为 需确认。
  • 保留用户的最新修正,覆盖旧笔记。
  • 对于做货建议/配码,区分已验证的需求、用户假设和明确的裁剪指令;使用 references/production-advice.md 结合需求、当前库存、及时的在途库存和裁剪约束。不要把假设的比例变成确认的销售模式。
  • 除非用户明确要求,否则不要创建新的成本类别或表格含义。
  • 使用腾讯文档时,优先使用 tencent-docs 技能/工具。如果 MCP 工具不可见,则使用目标环境已配置的腾讯文档连接器或凭据存储。

参考资料路由

仅读取当前任务所需的参考文件。

任务读取
成本表、面料费、布料费、加工费、缩水、辅料、杂费、扣子、洗水费、工厂出货数量写入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。

私有腾讯文档配置

公共仓库应仅保留 config/tencent-docs.example.json。

对于实际部署,从已安装技能目录下的 config/tencent-docs.local.json 或目标环境的私有配置中读取私有腾讯文档路由。不要提交本地配置。

预期的角色:

配置键含义
workbook腾讯文档工作簿元数据
sheets.inventory库存表
sheets.production_receipt默认生产/入库表
sheets.legacy_production可选旧生产表
sheets.cost成本表

如果缺少私有配置,请要求用户在读取或写入腾讯文档之前配置工作簿和 sheet ID。

默认输出样式

  • 使用简洁的表格显示 SKU、款号、数量、成本和写入预览。
  • 将已确认的事实与 需确认 项目分开。
  • 清晰地说明总数和对账差异。
  • 对于提醒或催办消息,在请求时提供简短的微信版本和结构化的飞书版本。

所需的成本表预览格式

在将提取的成本写入成本表时,至少预览:

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

同时提及目标文件、目标表、目标日期列、当前目标单元格值以及源总额对账。

所需的写入完成报告

写入后,报告:

  • 目标文件和表。
  • 写入的确切单元格。
  • 从腾讯文档回读的值。
  • 已检查的汇总/公式行。
  • 任何未解决的 需确认 项目。

跨技能路由

  • 聚水潭异常订单处理、审核提交和供应商金额监控属于单独的 jushuitan-order-monitor 技能;不要在此小红书工作流中执行它们。

Verwandte Skills