Agent Mail

Réservations de fichiers consultatives et messagerie pour coordonner plusieurs agents écrivant dans un même dépôt

par boshu2 · boshu2/agentops

Fonctionne avec configuration ★ 7.6/10

Agent Mail — Réservations de fichiers consultatives et messagerie pour coordonner plusieurs agents écrivant dans un même dépôt

Ce que fait

Agent Mail est une compétence Claude/Codex qui agit comme un adaptateur sur un backend externe "Agent Mail" (outils MCP ou une CLI `am`) pour coordonner plusieurs agents écrivant dans le même dépôt. Il enregistre les identités des agents, envoie des messages/accusés de réception threadés, et place des réservations de fichiers consultatives, limitées par TTL, afin que les rédacteurs coopérants évitent d'écraser les chemins des autres. Il se déclenche sur les demandes de coordination multi-agents comme "coordonner les rédacteurs" ou "réserver des fichiers".

Rapport de test

SKILL.md trouvé à skills/agent-mail/SKILL.md (mis en miroir dans skills-codex/ et images/gemini/skills/). Le frontmatter est parsé avec name+description ; les trois fichiers référencés (references/TOOLS.md, WORKFLOWS.md, RECOVERY.md) ont retourné HTTP 200 ; les chemins sont relatifs sans chemins machine codés en dur. Pas de failles de sécurité (pas de curl|sh, base64, ou exfiltration) ; il décrit un `clear-and-reset-everything` destructeur et une protection git pre-commit mais les protège tous deux derrière une autorisation explicite de l'appelant par opération. DÉCLENCHEUR : j'ai jugé 5 phrases — DEVRAIT : "coordonner deux agents éditant le même dépôt pour qu'ils n'écrasent pas les fichiers", "réserver src/auth/** pendant que je refactorise pour que l'autre rédacteur ne l'utilise pas", "mettre en place des réservations de fichiers pour notre session multi-agents" ; NE DEVRAIT PAS : "envoyer un e-mail à mon client concernant l'invoice", "réserver une salle de conférence pour la réunion d'équipe" — les 5 ont été décidées correctement (la description le limite clairement à la coordination agent-à-agent, pas au vrai courrier). SORTIE non mesurable : la compétence est un adaptateur léger dont chaque action nécessite les outils MCP Agent Mail ou une CLI `am`, et `which am` a retourné introuvable sans MCP présent ; je n'ai pu que fabriquer des identifiants/réservations, ce qui ne mesurerait pas honnêtement la compétence. DOCS solides et rafraîchissantes de non-survente (limite explicite "ne fait pas", modes de défaillance nommés), 1 point déduit car rien dans la compétence ou ses références ne dit comment obtenir/installer le backend dont toute la compétence dépend. Note : le frontmatter définit user-invocable:false (destiné à être consommé par la compétence native de l'agent), donc un humain ne l'invoquera pas directement.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/boshu2/agentops.git /tmp/agent-mail-src
mkdir -p ~/.claude/skills
cp -R /tmp/agent-mail-src/skills/agent-mail ~/.claude/skills/agent-mail
# REQUIRES an external "Agent Mail" backend that is NOT installed by the copy above:
# either the Agent Mail MCP tools (ensure_project, register_agent, send_message,
# file_reservation_paths, ...) registered in your client, OR a self-describing `am` CLI
# on PATH (discover syntax via `am mail --help`, `am file_reservations --help`).
# Neither ships in this skill folder; the skill only orchestrates them. Without one of
# them present the skill's own "Adapter unavailable" branch says to stop.
# `am`/agentops CLI appears to live in the repo's cli/ (Go); building/running it plus its
# datastore is a separate setup step not covered by the skill files.

Commandes et exemples de prompts

  • /agent-mailRéservations de fichiers consultatives et messagerie pour coordonner plusieurs agents écrivant dans un même dépôt

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Coordinate these two agents using Agent Mail
  • Set up a lock so agents don't collide on this file
  • Hand off this task to another agent via inbox