kl-autonomous/agent-team-skills

Bureau du propriétaire

Les questions dans le chat sont enterrées, et le propriétaire doit répondre quand l'agent demande, pas quand il a le temps. Le bureau les sort du chat pour les mettre dans un tableau : un onglet « Vous devez » avec chaque élément ouvert, un onglet jaune « Urgent » seulement quand quelque chose ne peut pas attendre, un onglet « Décidé » pour les réponses, un onglet « Plus tard » pour ce qui peut attendre, et une « Archive » pour ce qui est fait. Sur un téléphone ou un iPad, le propriétaire glisse latéralement pour passer d'un onglet à l'autre. Le propriétaire répond là ; vous lisez les réponses, agissez et archivez.

Ce dont cela a besoin

• Les artefacts Claude avec les capacités db et comments, sur claude.ai ou dans l'application de bureau Claude. Ajoutez assets uniquement si les éléments transporteront des fichiers joints.

• Outils :

  • Artifact, pour publier le tableau et télécharger des fichiers ;
  • ArtifactData, pour écrire et lire les éléments ;
  • ArtifactComments, pour surveiller le tableau et répondre aux commentaires qui vous réveillent.

  Chargez-les avec ToolSearch lorsqu'ils sont différés.

• Une session en boucle principale. Seule une session en boucle principale peut maintenir une surveillance ; un sous-agent ne le peut pas.

Sans cela, dites-le et gardez les questions dans le chat sous forme de liste numérotée. Ne faites pas semblant d'avoir un tableau.

Qui y écrit

Une seule session :

• le chef de cabinet, s'il y en a un (voir le skill chef-de-cabinet) ;
• sinon, la session qui travaille avec le propriétaire.

Deux rédacteurs numéroteraient deux fois les éléments et archiveraient le travail de l'autre.

Créer le tableau

1. Remplissez le modèle, assets/desk.html. Il a trois espaces réservés :

   • {{TITLE}} : le nom du tableau, deux à quatre mots, comme « Bureau Appli Recettes » ;
   • {{EYEBROW}} : une petite ligne au-dessus du titre, comme « Appli recettes · du chef de cabinet » ;
   • {{AGENT}} : qui lit les réponses, tel qu'il se lit en milieu de phrase : « le chef de cabinet », ou « Claude ». Mots simples seulement, sans guillemets.

   Par exemple :

   sed -e 's/{{TITLE}}/Bureau Appli Recettes/g' -e 's/{{EYEBROW}}/Appli recettes · du chef de cabinet/g' -e 's/{{AGENT}}/le chef de cabinet/g' <skill>/assets/desk.html > desk.html
   

2. Publiez-le avec l'outil Artifact :

   • capabilities: {"db": {}, "user": {}, "comments": {}}, plus "assets": {} si les éléments transporteront des fichiers ;
   • icon: "inbox" ;
   • une description d'une ligne.

   La publication démarre également la surveillance du tableau par cette session.

3. Vérifiez-le une fois : ArtifactData list sur la collection items. Elle est vide, et la page affiche « Rien ne vous attend. »

4. Donnez le lien au propriétaire et dites que le tableau lui est privé.

5. Écrivez le lien dans un fichier du projet (la page d'état, ou les notes du projet), afin qu'une nouvelle session puisse le retrouver.

Ouvert en dehors de Claude, dans un navigateur classique, la page affiche des exemples d'éléments factices avec une note l'indiquant. C'est pour les aperçus et les captures d'écran ; cela n'écrit jamais rien.

Être réveillé par les réponses

Une écriture dans la base de données ne vous réveille pas ; un commentaire envoyé à Claude le fait. Lorsque le propriétaire répond, marque une tâche comme effectuée ou pose une question, la page envoie un court commentaire dans le fil de discussion de l'élément, par exemple « № 12 · Ouvrir la bêta vendredi ? Réponse : Oui ». Ce commentaire réveille la session qui surveille le tableau.

• La publication démarre la surveillance, mais il ne s'agit d'une surveillance que lorsque ArtifactComments watch (sans url) liste le tableau comme connecté, avec les réponses automatiques armées.
• Une nouvelle session doit surveiller à nouveau, avec ArtifactComments watch et l'url du tableau. Les réponses automatiques ne s'arment que lorsque le propriétaire a donné ce lien dans son propre message, donc le lien va dans l'invite de redémarrage que le propriétaire colle.
• La page indique au propriétaire dans quel cas il se trouve : « …est prévenu au moment où vous répondez » ou « Sauvegardé ici ; … le lit lors de sa prochaine vérification ».
• Si les commentaires ne peuvent pas vous atteindre (ils sont désactivés, ou aucune session ne surveille), revenez à ces solutions :
  • lisez le bureau au début de chaque tour ;
  • demandez au propriétaire de dire « bureau » dans le chat après avoir répondu ;
  • proposez une vérification programmée, uniquement si le propriétaire le souhaite.

Un élément

Chaque élément est un document dans la collection items. Son identifiant de document est son handle : utilisez q<numéro> pour les décisions et t-<mot> pour les tâches. Utilisez des mots simples partout, car le propriétaire peut le lire sur un téléphone.

Champ	Écrit par	Ce qu'il contient
kind	vous	"decision" ou "task"
status	les deux	"open" ; la page définit "answered" ; vous définissez "archived"
later	vous	true le place sur l'onglet Plus tard
urgent	vous	true le place sur un onglet Urgent jaune et en haut de l'Aperçu. Uniquement pour ce qui ne peut pas attendre : une échéance aujourd'hui, ou quelque chose de cassé pour les utilisateurs
num	vous	un numéro courant, le même que vous utilisez dans le chat ; jamais réutilisé
title	vous	la question elle-même, à laquelle on peut répondre avec les choix, ou la tâche en tant qu'action
body, bullets	vous	courts paragraphes et points : pourquoi c'est important, ce que cela affecte
recommendation	vous	votre réponse d'abord, puis la raison, en une ou deux phrases
choices	vous	deux à quatre réponses ; par défaut Oui / Non
steps, stepsDone	vous ; page	les étapes d'une tâche, et celles cochées (index)
copies	vous	[{label, text}] : texte que le propriétaire collera ailleurs
links	vous	[{label, url, note}] : guides, pages, fichiers joints
from	vous	quelle session a demandé
priority	vous	1 en premier ; trie les éléments ouverts
created	vous	quand vous l'avez posté (heure ISO)
answer	page	{choice, note, at}
asks	page ; vous	[{q, at, via, a, aAt}] : les questions du propriétaire sur l'élément ; vous remplissez a et aAt
thread	page	le fil de commentaires que la page utilise pour cet élément ; laissez-le tranquille
outcome, archived	vous	ce qui s'est passé, en une ligne ; quand vous l'avez archivé

assets/example-items.json contient sept éléments factices, comme ArtifactData batch les écrit. Utilisez-les pour essayer un tableau, jamais sur le vrai tableau du propriétaire.

Poster des éléments

• Ajoutez de nouveaux éléments avec ArtifactData. Utilisez set pour un nouveau document, et batch pour plus de deux. Ne republiez jamais la page pour modifier les éléments.
• Dites ensuite dans le chat ce que vous avez ajouté, avec un lien vers chaque élément : <url du tableau>#<id du doc> ouvre son onglet et fait défiler jusqu'à lui.
• Si vous travaillez également à partir d'une liste de chat de questions ouvertes (comme le fait le chef de cabinet), gardez les deux identiques : le même numéro, les mêmes mots.
• Écrivez chaque élément pour qu'il soit autonome : ce qui est décidé, ce qui change dans un sens ou dans l'autre, et ce que vous recommandez.
• Une tâche liste les étapes exactes, le texte à coller dans copies, et le guide dans links.
• Pour joindre un fichier : lisez d'abord le fichier entier, puis téléchargez-le avec Artifact (url du tableau, asset: true) et liez-le comme /_blob/<id de l'actif>.
• Ne mettez jamais de mots de passe, de clés ou d'enregistrements privés dans un élément. Une tâche qui nécessite un secret dit où le taper, jamais ce qu'il est.

Lire, agir, archiver

Lorsqu'un commentaire vous réveille, ou au début d'un tour :

1. ArtifactData query sur items avec where: [["status", "==", "answered"]]. Lisez la answer de chaque élément et tout nouvel asks.
2. Agissez sur la réponse. Avec un chef de cabinet, relayez le choix et la note du propriétaire textuellement à la session qui a demandé.
   • Le commentaire et l'élément sont normalement d'accord.
   • Si l'élément n'est pas sauvegardé comme répondu, mais que le commentaire porte une réponse, le commentaire est le mot le plus récent du propriétaire. Écrivez-le vous-même dans l'élément.
3. Archivez l'élément : update avec status: "archived", un outcome d'une ligne (« Le constructeur a déplacé la bêta à vendredi »), et archived (l'heure). Épinglez chaque écriture avec if_version, afin qu'une réponse que le propriétaire modifie entre-temps ne soit pas écrasée.
4. Répondez à chaque entrée ouverte dans asks sur le même élément. Renvoyez tout le tableau asks, avec a et aAt remplis, épinglé avec if_version.
5. Répondez dans le fil de commentaires avec une ligne (« Compris : je déplace la bêta à vendredi »), puis résolvez le fil (ArtifactComments reply, puis resolve).

Placez un élément avec later: true, et ramenez-le avec later: false. Un élément décidé peut rester dans Plus tard jusqu'au moment d'agir. Archivez au lieu de supprimer : l'Archive est l'enregistrement de ce qui a été décidé. Supprimez uniquement sur la parole du propriétaire.

Statut et Feuille de route (optionnel)

Deux onglets supplémentaires montrent au propriétaire où en est le projet, entre l'Aperçu et les éléments. Chacun apparaît une fois que vous écrivez son document dans la collection board, et se met à jour en direct. Écrivez chacun avec ArtifactData (set la première fois, puis update épinglé avec if_version). assets/example-board.json contient une paire factice.

board/status : où en est chaque session. Mettez-le à jour chaque fois que vous vérifiez l'équipe ; un chef de cabinet l'écrit chaque fois qu'il met à jour sa page d'état.

Champ	Ce qu'il contient
updated	quand vous avez vérifié pour la dernière fois (heure ISO) ; la page montre depuis combien de temps
oneLine	où en est le projet, en une phrase
sessions	[{name, state, doing, last, restart}], une ligne par session. state est un mot ou deux (« En cours », « En attente », « Arrêté à une limite »), et la page le colorie. restart commence par « Oui » quand c'est un bon moment pour redémarrer cette session
done	ce qui s'est terminé depuis la dernière mise à jour, une ligne chacun
next	[{who, what}] : les prochaines étapes, celles du propriétaire aussi (who: "you")

L'onglet Statut compte lui-même les éléments urgents et ouverts du propriétaire ; ne les répétez pas dans oneLine.

board/roadmap : le plan, étape par étape. Mettez-le à jour lorsqu'une étape ou l'un de ses éléments bouge.

Champ	Ce qu'il contient
updated	quand vous l'avez changé pour la dernière fois
headline	où en est le projet dans son plan, en une phrase
stages	[{id, name, state, when, summary, items}], dans l'ordre. state est done, now, next ou later ; items sont [{text, state}] avec done, now ou next. L'étape marquée now s'ouvre en haut

Modifier la page

• Republiez la page uniquement pour modifier la page elle-même. Passez les mêmes capacités, ou omettez capabilities pour les conserver.
• Si une autre session a publié le tableau, lisez-le d'abord (Artifact read) et construisez sur ce qui revient.
• Les éléments vivent dans la base de données, donc ils survivent à une republication.