TongyiDai/agent-value-ledger

El tiempo es dinero | AI's time is money

Mantén un libro de contabilidad local en Excel que registre el valor del trabajo completado por el agente. El agente se encarga de descubrir, deduplicar, estimar y actualizar los registros; el usuario solo necesita revisar los elementos anómalos, sin tener que introducir datos manualmente línea por línea.

Límites de diseño

• Depende únicamente de Excel local; no requiere Feishu, Base, bases de datos ni servicios de sincronización externos.
• El libro registra el "valor de sustitución de tiempo auditable"; no expresa las cantidades estimadas como ingresos en efectivo, ganancias o beneficios determinados.
• Por defecto, muestra los valores conservadores bajos saved_minutes_low y saved_cny_low; los valores medio y alto solo se colocan en el rango de referencia de Excel.
• Solo registra trabajos con un estado de finalización claro o un entregable. Las discusiones de requisitos, preferencias registradas, intentos fallidos, mantenimiento repetitivo y conversaciones que solo contienen sugerencias sin resultados se omiten por defecto.
• No guarda conversaciones completas, texto original sensible, credenciales, detalles financieros privados ni datos personales innecesarios; la evidencia solo almacena un título corto, fecha, ID de origen, ruta local o tipo de entregable.

Estructura del libro

Se da prioridad al uso de assets/agent-value-ledger-template.xlsx proporcionado con la habilidad. Si el usuario ya tiene un libro, se lee y se mantiene su estructura; solo se crean las hojas necesarias si faltan.

• Resumen: Conclusión principal de valor bajo, resúmenes semanales/mensuales, rangos de referencia, nivel de confianza bajo y número de elementos pendientes de revisión. Todo impulsado por fórmulas.
• TareasDetalladas: Una fila por tarea completada. Tiempo, valor, nivel de confianza, evidencia y suposiciones se guardan en columnas separadas.
• Reglas: Tarifa por hora, coste por defecto, clasificación, nivel de confianza y límites de estimación. Los cambios en las reglas deben conservar la marca de tiempo de actualización.
• EstadoEjecución: Última hora de escaneo, ventana de escaneo, número de fuentes procesadas, errores recientes e instrucciones pendientes de revisión. Se utiliza para soportar el reescaneo sin depender de archivos de estado adicionales.
• RegistroEjecución: Solo registra eventos cortos, resultados y resúmenes de errores; no se escribe el texto original completo.

Los campos y fórmulas necesarios se encuentran en references/workbook-schema.md. Los criterios de estimación se detallan en references/estimation-policy.md. Los límites de desidentificación y evidencia se describen en references/redaction-and-evidence.md.

Flujo estándar

1. Leer libro y reglas

1. Encontrar el .xlsx especificado por el usuario; si no se especifica, buscar agent-value-ledger.xlsx en el directorio de trabajo actual o en el directorio de configuración.
2. Leer primero Reglas, EstadoEjecución, TareasDetalladas y Resumen, confirmando fórmulas, campos y estado de la última ejecución.
3. Si el libro no existe, copiar desde la plantilla a la ruta local indicada por el usuario; no escribir silenciosamente en directorios personales.
4. Leer la fecha actual, zona horaria, tarifa por hora y política de informes. No utilizar la tarifa por hora de ejemplo dentro de la habilidad como la tarifa real del usuario.

2. Escanear y reescanear

1. Escanear resúmenes de sesiones locales disponibles, registros de tareas, registros de proyectos, directorios de entregables y registros de versiones.
2. Por defecto, reescanear los últimos 7 días naturales, cubriendo casos en los que el resumen se guarda después de que la sesión finalice; cada vez se deduplica usando ID de tarea, ID de origen y huella digital del entregable.
3. Primero formar una lista de candidatos, luego determinar el estado de finalización. No escribir directamente en Excel mientras se escanea.
4. Marcar cada candidato como accepted, skipped o needs_review, y conservar una razón.

3. Formar registros de tareas

Cada tarea debe incluir al menos: ID de tarea, fecha de trabajo, título de la tarea, resumen corto, clasificación, fuente, entregable, nivel de confianza, tres rangos de tiempo manual, tres rangos de tiempo activo del usuario, tres rangos de tiempo de revisión/re trabajo, tarifa por hora, coste asignado, suposiciones, estado de la evidencia y clave de deduplicación.

Regla 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

Mantener las fórmulas en Excel; no codificar los resultados calculados de forma fija. Si no se pueden asignar los costes de suscripción/API, establecer el coste en 0 e indicar en las suposiciones "Coste de suscripción/API no asignado".

4. Comprobaciones previas a la escritura

• Si el ID de tarea, la clave de deduplicación o la huella digital del entregable ya existen: actualizar la evidencia u omitir, no añadir valor duplicado.
• Si falta evidencia de finalización: pasar a needs_review, no incluir en el resumen principal.
• Si saved_minutes es menor que 0: tratar como 0 y registrar la anomalía.
• Si el valor bajo es mayor que el valor medio o el valor medio es mayor que el valor alto: detener la escritura y corregir la estimación.
• Las "líneas de código, número de archivos, duración de ejecución" ingresadas manualmente solo pueden usarse como evidencia, no como equivalente directo del tiempo ahorrado.

5. Actualizar y validar

1. Escribir primero en TareasDetalladas, luego permitir que las fórmulas de Resumen recalculen.
2. Registrar EstadoEjecución y RegistroEjecución, incluyendo la ventana de escaneo, número de candidatos, nuevos, omitidos, pendientes de revisión y resumen de errores.
3. Releer las filas nuevas, las celdas clave del resumen y el resultado del escaneo de errores de fórmula.
4. Si ocurre un error de archivo no legible, error de fórmula, fuente inaccesible o fallo de escritura, dejar de adivinar; marcar el fallo y el alcance no validado en RegistroEjecución.
5. Al usuario solo informar la conclusión principal de valor bajo, el número real de tareas nuevas, los elementos pendientes de revisión y los bloqueos; no mostrar JSON sin procesar ni registros largos.

Clasificación de tareas

Utilizar la tabla de clasificación de la hoja Reglas. Las clasificaciones por defecto incluyen:

• simple_lookup_or_command: Consulta simple, explicación, un comando
• feishu_lookup_or_schedule: Consulta de mensajes, calendario, tareas y espacio de trabajo
• doc_wiki_minutes_synthesis: Documentos, Wiki, actas, traducción y organización estructural
• report_or_research: Investigación, análisis, propuestas y marcos de decisión
• automation_or_workflow_setup: Automatización, pipelines de datos, procesamiento por lotes, despliegue y configuración de flujos
• coding_or_debugging: Modificación de código, resolución de problemas, pruebas, lanzamiento y corrección
• local_setup_or_cleanup: Instalación local, limpieza, migración y mantenimiento

Seguridad y límites de publicación

• Solo se permite entrar en el repositorio público después de la desidentificación: eliminar nombres, correos electrónicos, números de teléfono, nombres de usuario en rutas, tokens, URL base, dominios internos, nombres de clientes de la empresa y títulos de documentos privados.
• El libro de ejemplo solo puede usar tareas ficticias y números de ejemplo; no copiar el historial del libro real del usuario.
• Antes de publicar en GitHub, ejecutar escaneo de información sensible, escaneo de errores de fórmula de Excel, validación de la estructura de la habilidad y revisión del contenido público.
• La publicación en GitHub no es un efecto secundario automático de esta habilidad; solo se ejecuta si el usuario solicita explícitamente la publicación y completa la revisión.

Recursos

• references/workbook-schema.md: Campos del libro, fórmulas y valores de estado.
• references/estimation-policy.md: Estimaciones de tres niveles, calibración de valor y límites anti-fraude.
• references/redaction-and-evidence.md: Desidentificación, minimización de evidencia y comprobaciones de publicación pública.
• scripts/build_template.mjs: Generar o reconstruir la plantilla de Excel desidentificada.