TongyiDai/agent-value-ledger

Le temps, c'est de l'argent｜AI's time is money

Maintenez un registre de valeur du travail accompli par un Agent à l'aide d'un classeur Excel local. L'Agent se charge de découvrir, dédupliquer, estimer et mettre à jour ; l'utilisateur ne fait que vérifier les anomalies, sans saisie manuelle ligne par ligne.

Périmètre de conception

• Dépend uniquement d'Excel local ; pas de dépendance à Feishu, Base, base de données ou service de synchronisation externe.
• Le registre enregistre la « valeur de remplacement de temps vérifiable » ; ne présente jamais les montants estimés comme un revenu en espèces, un profit ou un gain certain.
• Par défaut, les valeurs basses de saved_minutes_low et saved_cny_low sont affichées en externe ; les valeurs moyennes et hautes sont placées uniquement dans la zone de référence du fichier Excel.
• N'enregistre que les travaux avec un état d'achèvement ou un livrable clair. Saute par défaut les discussions sur les besoins, les préférences, les tentatives échouées, la maintenance répétée et les conversations sans résultat concret.
• Ne sauvegarde pas les conversations complètes, les textes originaux sensibles, les identifiants, les détails financiers privés ou les données personnelles inutiles ; les preuves ne conservent qu'un titre court, la date, l'ID source, le chemin local ou le type de livrable.

Structure du classeur

Utilisez de préférence le fichier assets/agent-value-ledger-template.xlsx fourni avec le Skill. Si l'utilisateur possède déjà un classeur, lisez-le et conservez sa structure ; ne créez les feuilles nécessaires que si elles sont absentes.

• 汇总 (Résumé) : conclusion principale à valeur faible, résumés hebdomadaires/mensuels, plages de référence, faible confiance et nombre d'éléments à vérifier. Entièrement piloté par des formules.
• 任务明细 (Détails des tâches) : une ligne par tâche terminée. Temps, valeur, confiance, preuves et hypothèses dans des colonnes séparées.
• 规则 (Règles) : taux horaire, coût par défaut, catégories, confiance et limites d'estimation. Conservez la date de mise à jour après modification.
• 运行状态 (État d'exécution) : date de la dernière analyse, fenêtre d'analyse, nombre de sources traitées, erreurs récentes et explications des éléments à vérifier. Utilisé pour les re-analyses, sans dépendre de fichiers d'état supplémentaires.
• 运行日志 (Journal d'exécution) : enregistre uniquement les événements courts, les résultats et les résumés d'erreurs, sans écrire le texte original complet.

Les champs et formules nécessaires se trouvent dans references/workbook-schema.md. La politique d'estimation est détaillée dans references/estimation-policy.md, et les limites de rédaction et de preuves dans references/redaction-and-evidence.md.

Processus standard

1. Lecture du classeur et des règles

1. Trouvez le fichier .xlsx spécifié par l'utilisateur ; s'il n'est pas spécifié, cherchez agent-value-ledger.xlsx dans le répertoire de travail actuel ou le répertoire de configuration.
2. Lisez d'abord les feuilles 规则, 运行状态, 任务明细 et 汇总 pour vérifier les formules, les champs et l'état de la dernière exécution.
3. Si le classeur n'existe pas, copiez le modèle vers le chemin local explicité par l'utilisateur ; n'écrivez pas silencieusement dans un répertoire personnel.
4. Lisez la date actuelle, le fuseau horaire, le taux horaire et la politique de rapport. N'utilisez pas le taux horaire d'exemple du Skill comme taux réel de l'utilisateur.

2. Analyse et re-analyse

1. Analysez les résumés de sessions locales disponibles, les enregistrements de tâches, les journaux de projet, les répertoires de livrables et les historiques de versions.
2. Par défaut, réanalysez les 7 derniers jours calendaires pour couvrir les cas où « le résumé est enregistré après la fin de la session » ; dédupliquez à chaque fois par ID de tâche, ID source et empreinte du livrable.
3. Formez d'abord une liste de candidats, puis jugez de l'état d'achèvement. N'écrivez pas directement dans Excel pendant l'analyse.
4. Marquez chaque candidat comme accepted, skipped ou needs_review, avec une raison.

3. Création d'enregistrement de tâche

Chaque tâche écrit au moins : ID de tâche, date de travail, titre de la tâche, résumé court, catégorie, source, livrable, confiance, trois niveaux de temps manuel, trois niveaux de temps utilisateur, trois niveaux de temps de relecture, taux horaire, coût alloué, hypothèses, statut de la preuve et clé de déduplication.

Règle de calcul :

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

Conservez les formules dans Excel, ne codez pas en dur les résultats. Si les coûts d'abonnement/API ne peuvent pas être alloués, mettez 0 pour le coût et mentionnez « Coûts d'abonnement/API non alloués » dans les hypothèses.

4. Vérification avant écriture

• L'ID de tâche, la clé de déduplication ou l'empreinte du livrable existent déjà : mettez à jour la preuve ou ignorez, n'ajoutez pas de valeur en double.
• Preuve d'achèvement manquante : entrez dans needs_review, n'incluez pas dans le résumé principal.
• saved_minutes inférieur à 0 : traitez comme 0 et enregistrez l'anomalie.
• La valeur basse est supérieure à la valeur moyenne, ou la valeur moyenne supérieure à la valeur haute : arrêtez l'écriture et corrigez l'estimation.
• Les « lignes de code, nombre de fichiers, durée d'exécution » saisis manuellement ne peuvent servir que de preuve, pas d'équivalent direct du temps économisé.

5. Mise à jour et validation

1. Écrivez d'abord dans 任务明细, puis laissez les formules de 汇总 se recalculer.
2. Enregistrez l'état dans 运行状态 et le journal dans 运行日志, incluant la fenêtre d'analyse, le nombre de candidats, les ajouts, les ignorés, les éléments à vérifier et le résumé des erreurs.
3. Relisez les nouvelles lignes, les cellules clés du résumé et les résultats de l'analyse des erreurs de formule.
4. En cas de fichier illisible, d'erreur de formule, de source inaccessible ou d'échec d'écriture, arrêtez les suppositions ; marquez l'échec et la plage non vérifiée dans 运行日志.
5. Rapportez à l'utilisateur uniquement la conclusion principale à valeur faible, le nombre réel de nouvelles tâches, les éléments à vérifier et les blocages ; ne sortez pas le JSON brut ou les longs journaux.

Catégories de tâches

Utilisez la table des catégories de la feuille 规则. Les catégories par défaut incluent :

• simple_lookup_or_command : requête simple, explication, une commande
• feishu_lookup_or_schedule : requêtes de messages, calendrier, tâches et tableau de bord
• doc_wiki_minutes_synthesis : documents, Wiki, comptes-rendus, traduction et organisation de structure
• report_or_research : étude, analyse, proposition et cadre de décision
• automation_or_workflow_setup : automatisation, pipeline de données, traitement par lots, déploiement et mise en place de flux
• coding_or_debugging : modification de code, débogage, test, publication et correction
• local_setup_or_cleanup : installation locale, nettoyage, migration et maintenance

Limites de sécurité et de publication

• La rédaction est obligatoire avant toute publication dans un dépôt public : supprimez noms, emails, numéros de téléphone, noms d'utilisateur dans les chemins, jetons, URL de base, noms de domaine internes, noms de clients d'entreprise et titres de documents privés.
• Le classeur d'exemple doit contenir uniquement des tâches fictives et des chiffres d'exemple ; ne copiez pas l'historique du registre réel de l'utilisateur.
• Avant la publication sur GitHub, effectuez une analyse des informations sensibles, une analyse des erreurs de formule Excel, une validation de la structure du Skill et une révision du contenu public.
• La publication sur GitHub n'est pas un effet secondaire automatique de ce Skill ; elle n'est exécutée qu'à la demande explicite de l'utilisateur et après une révision terminée.

Ressources

• references/workbook-schema.md : champs du classeur, formules et valeurs d'état.
• references/estimation-policy.md : estimation à trois niveaux, calibrage de la valeur et limites anti-triche.
• references/redaction-and-evidence.md : rédaction, minimisation des preuves et contrôles de publication publique.
• scripts/build_template.mjs : génère ou reconstruit le modèle Excel rédigé.