Pular para o conteúdo principal
TaskForge 3.0: a sua IA lê as suas tarefas.

O Copilot pode editar as suas tarefas como qualquer outro ficheiro

O modo agente do Copilot no VS Code lê e escreve os ficheiros no seu espaço de trabalho aberto. Abra o seu cofre Obsidian aí hoje mesmo e as suas tarefas, que são simples linhas de markdown, são apenas mais ficheiros que ele pode editar. O TaskForge acrescenta um ficheiro de contrato TaskForge/Settings/agents.md ao cofre, para que o Copilot acerte no seu formato exato em vez de adivinhar. Quer ferramentas tipadas em vez de edições livres? O VS Code fala MCP, e o servidor taskforge, que também vem com o TaskForge, também encaixa.

Abra o seu cofre, depois escolha um modo

O modo agente do Copilot edita ficheiros do espaço de trabalho diretamente, o que já é suficiente por si só. O servidor MCP está lá se quiser que o agente chame ferramentas de adicionar e concluir em vez de escrever linhas à mão.

  1. Gere o contrato do cofre

    Abra o seu cofre no TaskForge 3.0 ou posterior, depois Definições, IA e Agentes, e deixe "Gerar ficheiros para agentes" ativado. O TaskForge escreve uma pasta TaskForge/Settings/ que descreve o seu formato de tarefas, para que o Copilot escreva tarefas no seu dialeto.

  2. Abra o cofre como pasta no VS Code

    Ficheiro, Abrir Pasta, e escolha o seu cofre. O Copilot vê agora todas as notas, incluindo o contrato TaskForge/Settings/, como parte do espaço de trabalho.

  3. Use o modo agente e aponte-o para o contrato

    No painel de conversa do Copilot, mude para o modo agente para que possa editar ficheiros. Diga-lhe para ler o TaskForge/Settings/agents.md antes de adicionar ou alterar tarefas. Acrescente a mesma instrução a um .github/copilot-instructions.md e ela aplica-se a todas as sessões.

    # .github/copilot-instructions.md
    Esta pasta é um cofre Obsidian. Antes de adicionar ou editar
    tarefas, leia o TaskForge/Settings/agents.md e siga exatamente a sua sintaxe.
    O Copilot lê o guia e depois escreve uma linha de tarefa que as suas outras ferramentas conseguem ler.
  4. Ou adicione o servidor MCP taskforge

    O VS Code suporta servidores MCP. Adicione o taskforge e o agente do Copilot obtém as mesmas ferramentas tipadas que os clientes de computador usam: add_task, query_tasks, complete_task e o resto.

    // .vscode/mcp.json
    {
      "servers": {
        "taskforge": {
          "command": "npx",
          "args": ["-y", "taskforge-md", "mcp", "--stdio"],
          "env": { "TASKFORGE_VAULT": "/path/to/your/vault" }
        }
      }
    }
    O npx obtém o taskforge-md na primeira execução; defina TASKFORGE_VAULT para o caminho do seu cofre.

Como o Copilot acerta no seu formato

A pasta TaskForge/Settings/ é a fonte de verdade de qualquer forma. O modo agente lê o agents.md como um ficheiro do espaço de trabalho; o servidor MCP expõe os mesmos dados como recursos. Assim, o Copilot escreve uma tarefa no seu dialeto, com os seus campos com outro nome e símbolos de estado, em vez de um checkbox genérico.

TaskForge/Settings/agents.md A sua sintaxe de tarefas em inglês simples, o ficheiro para o qual apontam as suas instruções do Copilot.
TaskForge/Settings/dialect.json A versão legível por máquina, exposta ao servidor MCP como taskforge://dialect.
TaskForge/Settings/spaces.json Os seus Espaços guardados e para onde vão as tarefas novas, para que uma tarefa arquivada num Espaço com nome vá para a nota certa.

Prompts que funcionam

Peça ao Copilot no painel de conversa com o cofre aberto em modo agente. Ele lê o contrato, edita o markdown, e mostra a alteração como um diff que aprova.

Pede ao Copilot

“Lê o standup.md e adiciona cada uma das minhas ações a tasks/this-week.md, com prazo na sexta-feira.”

O que fica no ficheiro

- [ ] atualizar o runbook de deploy 📅 2026-07-10

- [ ] rever o PR de migração 📅 2026-07-10

O Copilot lê a nota e o contrato, depois escreve ambas as linhas na sintaxe do seu cofre e prepara o diff para o aceitar.

Pede ao Copilot

“Marca a tarefa do runbook de deploy como concluída e adiciona um seguimento para testar em staging na próxima segunda-feira.”

O que fica no ficheiro

- [x] atualizar o runbook de deploy ✅ 2026-07-07

- [ ] testar o runbook em staging 📅 2026-07-13

Conclui a primeira tarefa no lugar e acrescenta o seguimento. O TaskForge mostra ambas na próxima vez que lê o cofre.

As edições ficam no seu espaço de trabalho

O agente do Copilot edita os ficheiros na pasta que abriu, e o servidor MCP taskforge, se o adicionar, corre localmente. Sem conta TaskForge, sem cópia na nuvem das suas tarefas. A sua sincronização já existente, iCloud, Dropbox ou Obsidian Sync, move as edições para os seus outros dispositivos.

Perguntas que nos fazem

O GitHub Copilot pode mesmo editar as minhas tarefas do Obsidian?

Sim, em modo agente. O agente do Copilot lê e escreve os ficheiros no seu espaço de trabalho aberto do VS Code, por isso, com o seu cofre aberto, edita as suas linhas de tarefas markdown diretamente. Peça-lhe para ler primeiro o TaskForge/Settings/agents.md e as tarefas saem no seu formato.

Preciso do servidor MCP?

Não. O modo agente a editar ficheiros já é suficiente para a maioria das pessoas. Adicione o servidor MCP taskforge apenas se quiser que o Copilot chame ferramentas tipadas como add_task e complete_task em vez de editar linhas à mão. O VS Code suporta MCP, por isso ambos funcionam.

Isto precisa de um repositório GitHub?

Não. Qualquer pasta aberta no VS Code é um espaço de trabalho, incluindo um simples cofre Obsidian. O Copilot não se importa se é um repositório git, embora versionar o seu cofre com git seja uma boa rede de segurança para qualquer edição que um agente faça.

As tarefas aparecem na aplicação TaskForge?

Sim. O Copilot edita os mesmos ficheiros markdown que o TaskForge lê. A aplicação mostra a alteração nessa máquina de imediato, e chega ao seu telemóvel assim que a sincronização do cofre correr.

Como é que o Copilot conhece a minha sintaxe de tarefas?

Lê o TaskForge/Settings/agents.md, o contrato que o TaskForge escreve no seu cofre. Esse ficheiro descreve o seu dialeto exato, para que o Copilot escreva uma tarefa que as suas outras ferramentas conseguem ler, em vez de uma genérica.

Configurações relacionadas

O Copilot é um agente entre muitos. A visão geral de IA cobre o panorama completo, e as páginas do MCP e da CLI aprofundam cada superfície.

Gira as tarefas onde já escreve código.

Markdown simples no seu próprio cofre, editado pelo Copilot. O TaskForge é de transferência gratuita no iPhone, iPad, Mac, Android e Windows.