Agent Mail

Rådgivende filreservationer og beskeder til koordinering af flere agenter, der skriver til ét repo

Af boshu2 · boshu2/agentops

Virker med opsætning ★ 7.6/10

Agent Mail — Rådgivende filreservationer og beskeder til koordinering af flere agenter, der skriver til ét repo

Hvad det gør

Agent Mail er en Claude/Codex-færdighed, der fungerer som en adapter over en ekstern "Agent Mail"-backend (MCP-værktøjer eller en `am` CLI) til koordinering af flere agenter, der skriver til det samme repository. Den registrerer agentidentiteter, sender trådede beskeder/bekræftelser og placerer rådgivende, TTL-begrænsede filreservationer, så samarbejdende skribenter undgår at overskrive hinandens stier. Den udløses ved multi-agent koordinationsanmodninger som "coordinate writers" eller "reserve files".

Testrapport

SKILL.md fundet i skills/agent-mail/SKILL.md (spejlet i skills-codex/ og images/gemini/skills/). Frontmatter parses med name+description; alle tre refererede filer (references/TOOLS.md, WORKFLOWS.md, RECOVERY.md) returnerede HTTP 200; stier er relative uden hardkodede maskinstier. Ingen sikkerhedsbrister (ingen curl|sh, base64 eller eksfiltrering); den beskriver en destruktiv `clear-and-reset-everything` og en git pre-commit guard, men beskytter begge bag eksplicit per-operations kaldsautorisering. TRIGGER: Jeg bedømte 5 fraseringer — SKULLE: "coordinate two agents editing the same repo so they don't clobber files", "reserve src/auth/** while I refactor so the other writer stays off it", "set up file reservations for our multi-agent session"; SKULLE IKKE: "email my client about the invoice", "reserve a conference room for the team meeting" — alle 5 afgjort korrekt (beskrivelsen afgrænser den tydeligt til agent-til-agent koordinering, ikke rigtig mail). OUTPUT umåleligt: færdigheden er en tynd adapter, hvis hver handling kræver Agent Mail MCP-værktøjerne eller en `am` CLI, og `which am` returnerede ikke fundet uden MCP til stede; jeg kunne kun fabrikere ids/reservationer, hvilket ikke ærligt ville måle færdigheden. DOKUMENTATION solid og forfriskende ikke-oversælgende (eksplicit "does not do" grænse, navngivne fejltyper), fratrukket 1 point, fordi intet i færdigheden eller dens referencer fortæller, hvordan man opnår/installerer den backend, hele færdigheden afhænger af. Bemærk: frontmatter sætter user-invocable:false (beregnet til at blive forbrugt af den agent-native færdighed), så et menneske vil ikke påkalde den direkte.

Testet: 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.

Kommandoer og eksempelprompter

  • /agent-mailRådgivende filreservationer og beskeder til koordinering af flere agenter, der skriver til ét repo

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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