Communitygithub.com

AaronShine-X/ecommerce-inventory-ops-assistant

Asistente de operaciones de inventario para comercio electrónico: gestión de inventario, producción, costos, cotizaciones de proveedores y verificación de lectura/escritura con Tencent Docs para Xiaohongshu.

¿Qué es ecommerce-inventory-ops-assistant?

Este skill está diseñado para automatizar y centralizar el flujo de trabajo de inventario, producción y costos en plataformas de comercio electrónico como Xiaohongshu. Su propósito es permitir que un agente de IA (como Claude Code, Cursor o Codex) interactúe directamente con libros de Tencent Docs, realizando operaciones como consultar y actualizar inventarios, registrar producciones y recepciones, escribir tablas de costos, y verificar la consistencia de los datos mediante relectura posterior. El skill impone reglas estrictas: siempre usa datos en vivo de Tencent Docs, nunca sobrescribe fórmulas ni filas de resumen, y requiere una vista previa antes de cualquier escritura, a menos que el usuario envíe una imagen con instrucciones de corrección explícitas. Además, gestiona el enrutamiento a documentos de referencia según la tarea (costos, producción, pedidos, sugerencias de producción, etc.) y utiliza una configuración privada para los IDs de libros y hojas, garantizando que la información sensible no se exponga en el repositorio público.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

小红

小红 es el punto de entrada principal para el flujo de trabajo de inventario, producción y costos de Xiaohongshu para comercio electrónico. Los IDs del libro de Tencent Docs, los nombres de las hojas y los IDs de las hojas deben leerse desde una configuración local privada, y no deben escribirse en el archivo público del skill.

Reglas principales

  • Siempre usa datos en vivo de Tencent Docs para inventario, producción, recepción, envío, devolución a inventario y escrituras en la tabla de costos.
  • Usa la memoria y el historial de chat solo para límites, mapeos o advertencias; no reutilices cifras antiguas sin verificación en vivo.
  • Previsualiza antes de escribir cualquier tabla de Tencent Docs. Escribe solo después de que el usuario lo apruebe explícitamente.
  • Excepción: cuando el usuario envía una imagen y el texto que la acompaña dice 修正数量 / 修正一下数量 / 修正做货数量, trátalo como aprobación explícita para corregir cantidades de producción existentes. Sigue el flujo de corrección de references/production-table.md directamente: analiza la imagen, deja que las correcciones de texto anulen el OCR, relee las filas objetivo y las columnas de fecha, escribe solo las celdas de detalle de 做货数量 existentes, luego relee los detalles, G y la fila de resumen.
  • Después de escribir, relee las celdas/rangos objetivo e informa las celdas exactas más los valores releídos.
  • Nunca sobrescribas filas de resumen/fórmula.
  • En la hoja de producción/recepción configurada, la columna de cantidad no recibida es propiedad de fórmulas y es de solo lectura. Conserva las fórmulas existentes; nunca establezcas, borres, sobrescribas ni llenes manualmente. Si las fórmulas parecen incorrectas o no se actualizan, repórtalo y pregunta antes de cualquier reparación.
  • Si un valor, fila, mapeo, cantidad o categoría objetivo no está claro, marca 需确认.
  • Conserva la corrección más reciente del usuario por encima de notas anteriores.
  • Para 做货建议/配码, distingue la demanda verificada de las hipótesis del usuario y las instrucciones de corte explícitas; usa references/production-advice.md para combinar demanda, stock actual, tránsito oportuno y restricciones de corte. No conviertas una proporción hipotética en un patrón de ventas confirmado.
  • No crees nuevas categorías de costos o significados de tablas a menos que el usuario lo solicite explícitamente.
  • Al usar Tencent Docs, prefiere el skill/herramienta tencent-docs. Si las herramientas MCP no son visibles, usa el conector de Tencent Docs o el almacén de credenciales configurado en el entorno objetivo.

Enrutamiento de referencias

Lee solo el(los) archivo(s) de referencia necesario(s) para la tarea actual.

TareaLeer
Tabla de costos, gastos de tela, gastos de tejido, gastos de procesamiento, encogimiento, accesorios, gastos varios, botones, gastos de lavado, escritura de cantidades de envío de fábricareferences/cost-table.md
Producción, recepción, llenado de tablas, plan de producción, programación, mercancía no llegada, sincronización inversa de inventarioreferences/production-table.md
Pedidos de Xiaohongshu, estadísticas de SKU, análisis de inventario, sugerencias de reposición, consumo de los últimos siete días, alertas de inventario, tasa de devoluciónreferences/inventory-orders.md
Sugerencias de producción, proporción de tallas, asignación de un lote de tela, redondeo a enteros/decenas, reposición tras rotura de tallareferences/production-advice.md (también lee inventory-orders; al consultar planificación de producción o escribir, lee production-table)
Suministro a otros, punto de equilibrio, riesgo de devolución, cotización de ciclo de contrato, inventario de cierre de tienda, costo de capital, fluctuación de volumen de pedidos, beneficio objetivoreferences/supply-project-profit.md
Mapeo de estilos, puntos propensos a errores en escritura manual/OCR, correcciones más recientes del usuario, base de erroresreferences/mappings-errors.md

Para tareas mixtas, lee todas las referencias relevantes. Por ejemplo, "llenar la tabla de costos según la imagen de pago" requiere cost-table.md y a menudo mappings-errors.md.

Configuración privada de Tencent Docs

Los repositorios públicos deben mantener solo config/tencent-docs.example.json.

Para un despliegue real, lee el enrutamiento privado de Tencent Docs desde config/tencent-docs.local.json en el directorio del skill instalado, o desde la configuración privada del entorno objetivo. No subas la configuración local.

Roles esperados:

Clave de configuraciónSignificado
workbookMetadatos del libro de Tencent Docs
sheets.inventoryHoja de inventario
sheets.production_receiptHoja de producción/recepción predeterminada
sheets.legacy_productionHoja de producción heredada opcional
sheets.costTabla de costos

Si falta la configuración privada, pide al usuario que configure los IDs del libro y las hojas antes de leer o escribir en Tencent Docs.

Estilo de salida predeterminado

  • Usa tablas concisas para SKU, estilo, cantidad, costo y vistas previas de escritura.
  • Separa los hechos confirmados de los elementos 需确认.
  • Indica totales y diferencias de conciliación claramente.
  • Para recordatorios o mensajes de seguimiento, proporciona una versión corta para WeChat y una versión estructurada para Feishu cuando se solicite.

Forma de vista previa requerida para la tabla de costos

Al escribir costos extraídos en la tabla de costos, previsualiza al menos:

N° de estilo/ProyectoTienda de pertenenciaUbicación de llenadoFila del proyectoMonto propuesto

También menciona el archivo objetivo, la hoja objetivo, la columna de fecha objetivo, los valores actuales de las celdas objetivo y la conciliación del total de origen.

Informe de finalización de escritura requerido

Después de una escritura, informa:

  • Archivo y hoja objetivo.
  • Celdas exactas escritas.
  • Valores releídos desde Tencent Docs.
  • Filas de resumen/fórmula verificadas.
  • Cualquier elemento 需确认 no resuelto.

Enrutamiento entre skills

  • El manejo de excepciones de pedidos de Jushuitan, el envío de revisiones y el monitoreo de montos de proveedores pertenecen al skill separado jushuitan-order-monitor; no los ejecutes dentro de este flujo de trabajo de Xiaohongshu.

Skills relacionados