Tarefas

Veja tarefas de um serviço externo e escolha uma para o Clarvis executar.

Tasks conecta o Clarvis a um serviço externo de tarefas e issues. Você pode consultar os itens em um quadro e trabalhar neles com as ferramentas do Clarvis. As tarefas continuam no serviço externo; o Clarvis não cria um segundo banco de tarefas.

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:

{
  "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 verificar a conexão, alternar entre quadro e lista, filtrar por grupo ou texto, atualizar e ler os detalhes de uma tarefa. O quadro separa a etapa usada pelo Clarvis, o status original do serviço, o responsável e a reserva de trabalho ativa (claim). Ele não presume que todos os serviços oferecem o mesmo fluxo.

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 de agentes 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.

Saiba quando as alterações são permitidas

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 envia alterações uma de cada vez dentro de uma execução, com um identificador para evitar pedidos duplicados. Se uma falha de rede deixar o resultado incerto, ele lê a tarefa novamente, informa a incerteza e não repete a alteração automaticamente. Confira a tarefa no serviço externo antes de tentar outra vez.

Veja também

• Agentes
• Servidores MCP
• Extension Profiles
• Comandos
• Configuração