Tarefas, subtarefas, checklists e comentários no ClickUpfy

Classificação

Leia antes de alterar

Comece pela tarefa completa:

1
clickupfy task get <task-id> --markdown

Esse formato reúne metadados, descrição, subtarefas e checklist items em um documento. Para automação estruturada, use:

1
clickupfy task get <task-id> --json

Para obter somente a resposta original da API, sem a fila execution:

1
clickupfy task get <task-id> --raw

--markdown, --json e --raw são mutuamente exclusivos.

Entenda a fila executável

O objeto execution transforma a árvore em itens ordenados. Uma chave como task:86abc123 identifica uma tarefa ou subtarefa. Uma chave como checklist:check-1:item-1 identifica um item de checklist.

O resumo informa totais abertos e concluídos. Cada item inclui parentKey e depth, por isso um agente consegue trabalhar em uma subtarefa aninhada sem tratá-la como item independente.

A fila é uma projeção da leitura atual, não um segundo estado. Sempre releia a tarefa depois de uma mutação.

Crie uma tarefa

Use Markdown na descrição quando o ClickUp ClickApp correspondente estiver disponível:

1
clickupfy task create \
2
  --list <list-id> \
3
  --name "Implementar autenticação" \
4
  --markdown-content "Adicionar o fluxo de login e os testes." \
5
  --start-date 2026-08-01 \
6
  --due-date 2026-08-05

Datas aceitam o formato AAAA-MM-DD. Antes de criar, confira o fuso e a política de datas da equipe.

Para criar uma subtarefa, informe o pai:

1
clickupfy task create \
2
  --list <list-id> \
3
  --name "Criar testes de autenticação" \
4
  --parent <task-id> \
5
  --markdown-content "Cobrir sucesso, credencial inválida e limite."

Subtarefas podem receber novas subtarefas. A leitura executável preserva todos os níveis.

Monte checklists verificáveis

Crie o checklist na tarefa e depois os itens:

1
clickupfy checklist create <task-id> --name "Validação"
2
clickupfy checklist item-create <checklist-id> --name "Executar testes unitários"
3
clickupfy checklist item-create <checklist-id> --name "Executar build"

Os itens são criados abertos. Marque um item somente depois de executar sua verificação:

1
clickupfy checklist set \
2
  <task-id> <checklist-id> <item-id> \
3
  --resolved

Para reabrir:

1
clickupfy checklist set \
2
  <task-id> <checklist-id> <item-id> \
3
  --open

O ClickUpfy confirma primeiro que o item pertence à tarefa, grava o novo estado e relê a tarefa. O comando só comunica sucesso quando a API devolve o valor esperado.

Atualize campos

1
clickupfy task update <task-id> --status "em andamento"
2
clickupfy task update <task-id> --priority 2
3
clickupfy task update <task-id> --start-date 2026-08-01
4
clickupfy task update <task-id> --due-date 2026-08-05
5
clickupfy task update <task-id> --points 5

As prioridades seguem a API do ClickUp:

Consulte list get antes de definir status. Para remover datas:

1
clickupfy task update <task-id> --clear-start-date
2
clickupfy task update <task-id> --clear-due-date

Registre progresso em comentários

1
clickupfy comment list --task <task-id>
2
clickupfy comment create \
3
  --task <task-id> \
4
  --text "Testes focais passaram. Iniciando a regressão."

Um comentário útil registra um evento verificável: início, impedimento, checkpoint de teste ou conclusão. Evite publicar raciocínio interno, secrets, logs extensos ou promessas sem evidência.

Exclua apenas com alvo confirmado

1
clickupfy task delete <task-id> --yes

A exclusão é permanente na interface do CLI e exige confirmação. Leia a tarefa, confira List e nome e confirme se a solicitação autoriza exclusão antes de usar --yes.

Quando a equipe trabalha por ciclos, continue em Sprints e Sprint Points.