OpenProse

OpenProse è un formato workflow portabile, markdown-first per orchestrare sessioni AI. In Mayros viene fornito come plugin che installa un pacchetto skill OpenProse più un comando slash /prose. I programmi risiedono in file .prose e possono generare più sub-agenti con controllo di flusso esplicito.

Sito ufficiale: https://www.prose.md

Cosa può fare

• Ricerca multi-agente + sintesi con parallelismo esplicito.
• Workflow ripetibili sicuri per approvazione (revisione codice, triage incidenti, pipeline contenuti).
• Programmi .prose riutilizzabili che puoi eseguire su runtime agente supportati.

Installa + abilita

I plugin inclusi sono disabilitati per impostazione predefinita. Abilita OpenProse:

bashCopy
mayros plugins enable open-prose

Riavvia il Gateway dopo aver abilitato il plugin.

Dev/checkout locale: mayros plugins install ./extensions/open-prose

Documentazione correlata: Plugin, Manifesto plugin, Skills.

Comando slash

OpenProse registra /prose come comando skill invocabile dall'utente. Instrada alle istruzioni VM OpenProse e usa strumenti Mayros sotto il cofano.

Comandi comuni:

/prose help
/prose run <file.prose>
/prose run <handle/slug>
/prose run <https://example.com/file.prose>
/prose compile <file.prose>
/prose examples
/prose update

Esempio: un semplice file .prose

proseCopy
# Ricerca + sintesi con due agenti che girano in parallelo.

input topic: "Cosa dovremmo ricercare?"

agent researcher:
  model: sonnet
  prompt: "Ricerchi in modo approfondito e citi le fonti."

agent writer:
  model: opus
  prompt: "Scrivi un riepilogo conciso."

parallel:
  findings = session: researcher
    prompt: "Ricerca {topic}."
  draft = session: writer
    prompt: "Riassumi {topic}."

session "Unisci i findings + draft in una risposta finale."
context: { findings, draft }

Posizioni file

OpenProse mantiene lo stato in .prose/ nel tuo workspace:

.prose/
├── .env
├── runs/
│   └── {YYYYMMDD}-{HHMMSS}-{random}/
│       ├── program.prose
│       ├── state.md
│       ├── bindings/
│       └── agents/
└── agents/

Gli agenti persistenti a livello utente risiedono in:

~/.prose/agents/

Modalità stato

OpenProse supporta più backend di stato:

• filesystem (predefinito): .prose/runs/...
• in-context: transitorio, per programmi piccoli
• sqlite (sperimentale): richiede binario sqlite3
• postgres (sperimentale): richiede psql e una stringa di connessione

Note:

• sqlite/postgres sono opt-in e sperimentali.
• Le credenziali postgres fluiscono nei log dei subagent; usa un DB dedicato con privilegi minimi.

Programmi remoti

/prose run <handle/slug> risolve a https://p.prose.md/<handle>/<slug>. Gli URL diretti vengono recuperati così com'è. Questo usa lo strumento web_fetch (o exec per POST).

Mappatura runtime Mayros

I programmi OpenProse mappano alle primitive Mayros:

Se la tua allowlist strumenti blocca questi strumenti, i programmi OpenProse falliranno. Vedi Configurazione skills.

Sicurezza + approvazioni

Tratta i file .prose come codice. Rivedi prima di eseguire. Usa allowlist strumenti Mayros e gate approvazione per controllare gli effetti collaterali.

Per workflow deterministici con gate approvazione, confronta con Lobster.