AaronShine-X/ecommerce-inventory-ops-assistant

小红

小红 é a entrada principal para o fluxo de trabalho de estoque, produção e custos do e-commerce Xiaohongshu. O workbook, nomes de planilhas e IDs de sheet do Tencent Docs devem ser lidos de uma configuração local privada e não devem ser escritos em arquivos públicos do skill.

Regras Principais

• Sempre use dados ao vivo do Tencent Docs para estoque, produção, recebimento, envio, retorno ao estoque e escritas na tabela de custos.
• Use memória e chat anterior apenas para limites, mapeamentos ou avisos; não reutilize figuras antigas sem verificação ao vivo.
• Visualize antes de escrever qualquer tabela do Tencent Docs. Escreva apenas após o usuário aprovar claramente.
• Exceção: quando o usuário enviar uma imagem e o texto que a acompanha disser 修正数量 / 修正一下数量 / 修正做货数量, trate como aprovação explícita para corrigir quantidades de produção existentes. Siga o fluxo de correção references/production-table.md diretamente: analise a imagem, deixe correções de texto substituírem o OCR, releia as linhas-alvo e colunas de data, escreva apenas as células de detalhe 做货数量 existentes, depois releia detalhes, G e a linha de resumo.
• Após escrever, releia células/intervalos-alvo e relate células exatas mais valores lidos de volta.
• Nunca sobrescreva linhas de resumo/fórmula.
• Na planilha configurada de produção/recebimento, a coluna de quantidade não recebida é de propriedade de fórmula e somente leitura. Preserve fórmulas existentes; nunca defina, limpe, sobrescreva ou preencha manualmente. Se as fórmulas parecerem erradas ou não atualizarem, relate e pergunte antes de qualquer reparo.
• Se um valor, linha, mapeamento, quantidade ou categoria alvo não estiver claro, marque 需确认.
• Preserve a correção mais recente do usuário sobre anotações mais antigas.
• Para 做货建议/配码, distinga demanda verificada de hipóteses do usuário e instruções explícitas de corte; use references/production-advice.md para combinar demanda, estoque atual, trânsito oportuno e restrições de corte. Não transforme uma proporção hipotética em um padrão de vendas confirmado.
• Não crie novas categorias de custo ou significados de tabela a menos que o usuário peça explicitamente.
• Ao usar Tencent Docs, prefira o skill/ferramenta tencent-docs. Se ferramentas MCP não estiverem visíveis, use o conector Tencent Docs configurado no ambiente alvo ou o armazenamento de credenciais.

Roteamento de Referência

Leia apenas o(s) arquivo(s) de referência necessário(s) para a tarefa atual.

Tarefa	Leitura
Tabela de custos, custo de tecido, custo de pano, custo de processamento, encolhimento, acessórios, despesas diversas, botões, custo de lavagem, escrita de quantidade de envio da fábrica	references/cost-table.md
Fabricação, recebimento, preenchimento de tabela, plano de produção, programação, não recebido, sincronização reversa de estoque	references/production-table.md
Pedidos Xiaohongshu, estatísticas SKU, análise de estoque, sugestões de reposição, consumo dos últimos 7 dias, alerta de estoque, taxa de devolução	references/inventory-orders.md
Sugestão de fabricação, proporção de tamanhos, alocação de um rolo de tecido, arredondamento para inteiros/dezenas, reposição após falta de tamanho	references/production-advice.md (leia também inventory-orders; ao verificar programação ou escrever, leia também production-table)
Fornecimento para terceiros, ponto de equilíbrio, risco de devolução, cotação de ciclo de contrato, estoque de fechamento de loja, custo de capital, variação de volume de pedidos, lucro alvo	references/supply-project-profit.md
Mapeamento de números de estilo, pontos propensos a erro em manuscrito/OCR, correções mais recentes do usuário, banco de erros	references/mappings-errors.md

Para tarefas mistas, leia todas as referências relevantes. Por exemplo, "preencher tabela de custos com base em imagem de pagamento" requer cost-table.md e frequentemente mappings-errors.md.

Configuração Privada do Tencent Docs

Repositórios públicos devem manter apenas config/tencent-docs.example.json.

Para uma implantação real, leia o roteamento privado do Tencent Docs de config/tencent-docs.local.json no diretório onde o skill está instalado, ou da configuração privada do ambiente alvo. Não faça commit da configuração local.

Funções esperadas:

Chave de configuração	Significado
workbook	Metadados do workbook do Tencent Docs
sheets.inventory	Planilha de estoque
sheets.production_receipt	Planilha padrão de produção/recebimento
sheets.legacy_production	Planilha de produção legada opcional
sheets.cost	Tabela de custos

Se a configuração privada estiver faltando, peça ao usuário para configurar o workbook e os IDs de sheet antes de ler ou escrever no Tencent Docs.

Estilo de Saída Padrão

• Use tabelas concisas para SKU, estilo, quantidade, custo e visualizações de escrita.
• Separe fatos confirmados de itens 需确认.
• Indique totais e diferenças de reconciliação claramente.
• Para lembretes ou mensagens de cobrança, forneça uma versão curta para WeChat e uma versão estruturada para Feishu quando solicitado.

Forma de Visualização Obrigatória da Tabela de Custos

Ao escrever custos extraídos na tabela de custos, visualize pelo menos:

Número do item/Projeto	Pertencimento à loja	Local de preenchimento	Linha do projeto	Valor a ser preenchido

Mencione também arquivo alvo, planilha alvo, coluna de data alvo, valores atuais das células alvo e reconciliação de total da fonte.

Relatório de Conclusão de Escrita Obrigatório

Após uma escrita, relate:

• Arquivo e planilha alvo.
• Células exatas escritas.
• Valores lidos de volta do Tencent Docs.
• Linhas de resumo/fórmula verificadas.
• Quaisquer itens 需确认 não resolvidos.

Roteamento Entre Skills

• Tratamento de exceções de pedidos Jushuitan, envio de revisão e monitoramento de valores de fornecedor pertencem ao skill separado jushuitan-order-monitor; não os execute dentro deste fluxo de trabalho Xiaohongshu.