Propose brief edit

propose_brief_edit

Scrittura

Cosa fa

Propose new wording for a project's or a task's agent brief (notes_for_agent) WITHOUT writing it. Briefs are the human's standing instructions to you, one-way, so you can never write one — but when a task has been sent back for a reason the brief should have covered, you are the one who knows the line that is missing. Give tier ("project" or "task"), target_id (the project or task id), text (the WHOLE brief as you propose it — a full replacement, not a patch; include what should stay), a reason (what went wrong and how this wording prevents it — this is what the human decides on), and source_task_id for the rejected task that prompted it. Nothing changes until a person applies it on the Needs you screen, where they see current vs proposed. It records the brief as you saw it: if someone edits that brief before yours is read, applying is refused rather than overwriting them. One open proposal per brief. The workspace brief can't be proposed here — it reaches every project, a teammate's agents included; use ask_decision for that.

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`tier`	`string`	Obbligatorio	Which brief: the project's, or one task's own Valori ammessi`projecttask`
`target_id`	`string`	Obbligatorio	The project id (tier project) or task id (tier task)
`text`	`string \| null`	Obbligatorio	The full proposed brief. null or empty proposes clearing it.
`reason`	`string`	Obbligatorio	Why — what was rejected and how this wording stops it happening again.
`source_task_id`	`string`	Facoltativo	The rejected task that prompted this, if any
`agent`	`string`	Facoltativo	Your name, for the record (a scoped token's own name wins)

Annotazioni

Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.

Sola letturareadOnlyHint: false: Modifica dati nel tuo account Done.
DistruttivodestructiveHint: false: Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: false: Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
Mondo apertoopenWorldHint: false: Tocca solo il tuo account Done.

Quali token possono chiamarlo

Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.

Accesso completoConsentito
Token di sola letturaRifiutato
Token per un progettoConsentito
Token per uno spazio di lavoroConsentito

Provalo

Con Done collegato, chiedi al tuo assistente qualcosa come:

“Quel rifiuto è qualcosa che le istruzioni del progetto avrebbero dovuto coprire. Proponi una nuova formulazione.”

Collega Done al tuo assistente

Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client:

Panoramica della configurazione MCP →