TongyiDai/agent-value-ledger

Tempo é Dinheiro | O tempo da IA é dinheiro

Mantenha um livro contábil local em Excel para registrar o valor do trabalho concluído pelo Agente. O Agente é responsável por descobrir, deduplicar, estimar e atualizar; o usuário apenas revisa itens anômalos, sem preencher manualmente linha por linha.

Limites de Projeto

• Depende apenas de Excel local; não depende de Feishu, Base, banco de dados ou serviços de sincronização externos.
• O livro contábil registra "valor substituto de tempo auditável", sem apresentar valores estimados como receita em dinheiro, lucro ou ganho determinado.
• Por padrão, exibe externamente os valores conservadores baixos saved_minutes_low e saved_cny_low; valores médios e altos ficam apenas na faixa de referência do Excel.
• Registra apenas trabalhos com estado de conclusão claro ou entregáveis. Discussões de requisitos, registros de preferências, tentativas fracassadas, manutenção repetitiva e conversas com apenas sugestões e sem produção são ignoradas por padrão.
• Não armazena conversas completas, texto original sensível, credenciais, detalhes financeiros privados ou dados pessoais desnecessários; as evidências mantêm apenas título curto, data, ID de origem, caminho local ou tipo de entregável.

Estrutura da Pasta de Trabalho

Priorize o uso do arquivo assets/agent-value-ledger-template.xlsx fornecido com a Skill. Quando o usuário já possui uma pasta de trabalho, leia e mantenha sua estrutura; crie planilhas necessárias apenas se estiverem faltando.

• Resumo: conclusão principal de valor baixo, resumos semanais/mensais, faixa de referência, baixa confiança e quantidade pendente de revisão. Tudo orientado por fórmulas.
• Detalhes de Tarefas: uma linha por tarefa concluída. Tempo, valor, confiança, evidências e suposições são armazenados em colunas separadas.
• Regras: taxa horária, custo padrão, classificação, confiança e limites de estimativa. Deve manter o timestamp de atualização ao alterar regras.
• Estado de Execução: timestamp da última varredura, janela de varredura, número de fontes processadas, erros recentes e instruções pendentes de revisão. Usado para suportar re-varredura, sem depender de arquivos de estado adicionais.
• Log de Execução: registra apenas eventos curtos, resultados e resumos de erros, sem escrever texto original completo.

Campos necessários e fórmulas são detalhados em references/workbook-schema.md. A política de estimativa está em references/estimation-policy.md. Os limites de anonimização e evidência estão em references/redaction-and-evidence.md.

Fluxo Padrão

1. Ler Pasta de Trabalho e Regras

1. Localizar o .xlsx especificado pelo usuário; se não especificado, procurar agent-value-ledger.xlsx no diretório de trabalho atual ou no diretório de configuração.
2. Primeiro, ler as planilhas Regras, Estado de Execução, Detalhes de Tarefas e Resumo, confirmando fórmulas, campos e o estado da última execução.
3. Se a pasta de trabalho não existir, copiar do modelo para o caminho local explícito do usuário; não escrever silenciosamente em diretórios pessoais.
4. Ler data atual, fuso horário, taxa horária e política de relatório. Não usar a taxa horária de exemplo dentro da Skill como a taxa horária real do usuário.

2. Varredura e Re-varredura

1. Escanear resumos de sessões locais disponíveis, registros de tarefas, logs de projetos, diretórios de entregáveis e registros de versão.
2. Por padrão, re-escaneie os últimos 7 dias corridos, cobrindo casos em que "resumo é escrito após o término da sessão"; cada vez, deduplique por taskID, ID de origem e impressão digital do entregável.
3. Primeiro, formar uma lista de candidatos, depois determinar o estado de conclusão. Não escrever diretamente no Excel enquanto escaneia.
4. Para cada candidato, marcar accepted, skipped ou needs_review, e manter uma breve justificativa.

3. Formar Registro de Tarefa

Cada tarefa deve registrar no mínimo: ID da tarefa, data de trabalho, título da tarefa, resumo curto, classificação, origem, entregável, confiança, três faixas de tempo manual, três faixas de tempo do usuário, três faixas de retrabalho de revisão, taxa horária, custo alocado, suposições, estado da evidência e chave de deduplicação.

Regra de cálculo:

saved_minutes = max(0, manual_minutes - user_active_minutes - review_minutes)
saved_cny = saved_minutes / 60 * hourly_rate_cny - allocated_cost_cny

Manter fórmulas no Excel, não codificar os resultados calculados. Se não for possível alocar custos de assinatura/API, preencher custo como 0 e anotar nas suposições "Custos de assinatura/API não alocados".

4. Verificação Antes de Escrever

• Se taskID, chave de deduplicação ou impressão digital do entregável já existirem: atualizar evidências ou pular, não adicionar valor duplicado.
• Se faltar evidência de conclusão: entrar como needs_review, não incluído no resumo principal.
• Se saved_minutes for menor que 0: tratar como 0 e registrar exceção.
• Se valor baixo for maior que valor médio ou valor médio maior que valor alto: parar a escrita e corrigir a estimativa.
• "Linhas de código, número de arquivos, tempo de execução" inseridos manualmente só podem servir como evidência, não como equivalência direta de tempo economizado.

5. Atualização e Validação

1. Primeiro escrever em Detalhes de Tarefas, depois permitir que as fórmulas de Resumo recalculem.
2. Registrar Estado de Execução e Log de Execução, incluindo janela de varredura, número de candidatos, novos, ignorados, pendentes de revisão e resumo de erros.
3. Re-ler as novas linhas adicionadas, células-chave de resumo e resultados de varredura de erros de fórmula.
4. Quando ocorrer arquivo ilegível, erro de fórmula, fonte inacessível ou falha de escrita, parar de adivinhar; marcar falha e escopo não verificado no Log de Execução.
5. Reportar ao usuário apenas a conclusão principal de valor baixo, número real de novas tarefas adicionadas, itens pendentes de revisão e bloqueios; não exibir JSON bruto ou logs longos.

Classificação de Tarefas

Use a tabela de classificação da planilha Regras. As classificações padrão incluem:

• simple_lookup_or_command: consulta simples, explicação, um comando
• feishu_lookup_or_schedule: consulta de mensagens, agenda, tarefas e Workbench
• doc_wiki_minutes_synthesis: documentos, Wiki, atas, tradução e organização estruturada
• report_or_research: pesquisa, análise, proposta e estrutura de decisão
• automation_or_workflow_setup: automação, pipeline de dados, processamento batch, implantação e configuração de fluxo
• coding_or_debugging: modificação de código, resolução de problemas, teste, release e correção
• local_setup_or_cleanup: instalação local, limpeza, migração e manutenção

Limites de Segurança e Publicação

• Anonimização é necessária antes de permitir entrada em repositório público: remover nomes, e-mails, números de telefone, nomes de usuário em caminhos, tokens, URLs de base, domínios internos, nomes de clientes da empresa e títulos de documentos privados.
• A pasta de trabalho de exemplo deve usar apenas tarefas fictícias e números de exemplo; não copiar histórico do livro contábil real do usuário.
• Antes da publicação no GitHub, executar varredura de informações sensíveis, varredura de erros de fórmula do Excel, validação de estrutura da Skill e revisão de conteúdo público.
• A publicação no GitHub não é um efeito colateral automático desta Skill; só deve ser executada após o usuário solicitar explicitamente a publicação e concluir a revisão.

Recursos

• references/workbook-schema.md: campos da pasta de trabalho, fórmulas e valores de estado.
• references/estimation-policy.md: estimativa de três faixas, calibração de valor e limites anti-fraude.
• references/redaction-and-evidence.md: anonimização, minimização de evidências e verificação de publicação pública.
• scripts/build_template.mjs: gera ou reconstrói o modelo Excel anonimizado.