# Tarefas

> Navegue por itens de trabalho externos, vincule um deles à execução de um agente e altere o ciclo
> de vida por operações explícitas do provedor.

Tasks conecta o Clarvis a um issue tracker ou sistema externo de gestão de trabalho. O Clarvis
normaliza os itens do provedor em um único quadro e vocabulário de ferramentas, mas não mantém um
segundo banco de tarefas. O provedor externo continua sendo a fonte da verdade.

## Configure um provedor de tarefas

Tasks usa um servidor MCP nomeado que implementa o protocolo `clarvis.tasks.v2`. Depois de declarar
e conectar esse servidor, adicione o provedor ao `settings.json` global ou do workspace:

```json
{
  "tasks": {
    "provider": {
      "kind": "mcp",
      "server": "tracker:tasks",
      "protocol": "clarvis.tasks.v2"
    },
    "default_container": "engineering",
    "writes": "disabled"
  }
}
```

`default_container` é opcional. Escritas vêm desativadas por padrão; mude `writes` para `enabled`
somente depois de revisar o servidor conectado e os agentes com permissões `tasks.*`. Configuração
do provedor, instalação de plugin e ativação no Extension Profile continuam sendo decisões separadas.

## Navegue pelo provedor no Clarvis

Abra `/tasks` para ver a saúde do provedor, alternar entre quadro e lista, filtrar por container ou
texto, atualizar e abrir os detalhes completos de uma tarefa. O Clarvis mantém separados estágio
normalizado, estado nativo do provedor, responsável e claim ativo, sem fingir que o provedor oferece
uma semântica que não suporta.

Falhas de leitura, conflitos e resultados incertos de uma mutação aparecem como estados explícitos,
não como um quadro vazio. Ao voltar do trabalho de um agente, o Clarvis atualiza a tarefa a partir da
fonte externa da verdade.

## Inspecione uma tarefa ou trabalhe nela

Selecionar **Work on task** abre o seletor normal de Agent Profiles e inicia uma execução no
workspace atual vinculada à tarefa externa. A descrição entra na execução como dados de trabalho não
confiáveis; ela não pode trocar o workspace, conceder ferramentas, desativar controles de segurança
nem selecionar um provedor.

O acesso a tarefas tem dois modos:

- `inspect` oferece apenas operações de leitura;
- `work` pode oferecer escritas compatíveis quando configuração, permissões do agente escolhido e
  capacidades anunciadas pelo provedor permitem.

Abrir uma tarefa em modo de trabalho não a altera. O agente precisa chamar `start_task`
explicitamente, e encerrar uma execução do Clarvis nunca conclui, reabre nem envia automaticamente a
tarefa externa para revisão.

## Entenda os gates de escrita

Uma ferramenta de escrita só fica disponível quando as quatro condições concordam:

1. `tasks.writes` está como `enabled`;
2. a execução vinculada usa o modo `work`;
3. o agente escolhido tem a permissão `tasks.*` correspondente;
4. o provedor anuncia aquela operação ou transição de ciclo de vida.

O Clarvis serializa escritas dentro de uma execução e usa requisições com idempotência. Se uma falha
de rede deixar o resultado incerto, o Clarvis lê a tarefa novamente, registra a incerteza e se recusa
a repetir a escrita automaticamente. Inspecione a tarefa externa antes de fazer uma tentativa
explícita.

## Veja também

- [Agentes](/pt-BR/guide/agents)
- [Servidores MCP](/pt-BR/guide/mcp-servers)
- [Extension Profiles](/pt-BR/guide/extension-profiles)
- [Comandos](/pt-BR/reference/commands)
- [Configuração](/pt-BR/reference/configuration)

---

[HTML canônico](https://clarvis.dev/pt-BR/guide/tasks)

[Índice da documentação](https://clarvis.dev/pt-BR/llms.txt)