Clarvis

Português (Brasil)

English

Português (Brasil)

English

Aparência

Esta documentação descreve o Clarvis v0.1.0.

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.

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 ​