O Spec Kit escreve os documentos.O DotMD é onde os revê.

O que é o GitHub Spec Kit

O Spec Kit é o toolkit de código aberto do GitHub para o desenvolvimento orientado por specs. Não substitui o seu agente. Acrescenta uma ferramenta de linha de comandos, specify, que prepara o projeto, e um conjunto de comandos que executa no chat do agente. O agente escreve; o Spec Kit dá-lhe os passos e a estrutura.

Suporta muitos agentes, incluindo o Claude Code, o Codex CLI e o Cursor. A lista completa está na página de integrações do Spec Kit.

Instale e inicialize

Precisa do Python 3.11 ou posterior e do uv. Depois:

uv tool install specify-cli
specify init my-project --integration claude

A opção --integration recebe a chave do seu agente: claude para o Claude Code, codex para o Codex CLI, cursor-agent para o Cursor. A página do Spec Kit lista a chave de cada um dos outros agentes.

Os comandos, por ordem

Escreve-os no chat do agente, não no terminal:

1. /speckit-constitution
2. /speckit-specify: escreve spec.md.
3. /speckit-plan: escreve plan.md.
4. /speckit-tasks: escreve tasks.md.
5. /speckit-implement: constrói a partir das tarefas.
6. /speckit-converge

A grafia de um comando varia consoante o agente: alguns usam /speckit.specify, outros um hífen ou um $. O Spec Kit explica as formas para cada agente nas suas notas sobre a invocação de comandos.

Reveja cada passo no DotMD

O Spec Kit pede-lhe que reveja cada resultado antes de continuar. O DotMD transforma isso numa revisão a sério, em vez de uma vista de olhos no terminal.

1. Abra o projeto

   Prima ⌘O e escolha a pasta do projeto. Os ficheiros que o Spec Kit escreve aparecem na barra lateral à medida que são criados, formatados com os seus títulos, listas e tabelas.

2. Comente a linha exata

   Leia spec.md, selecione um requisito errado ou vago e prima ⌥⌘M. Escreva o que mudar. Os comentários são guardados pelo DotMD, não no ficheiro.

3. Peça ao agente que os corrija

   Diga ao agente: “Go through my comments in DotMD.” Ele lê-os por MCP e edita o ficheiro. Cada correção é mostrada junto ao seu comentário, o texto antigo a vermelho e o novo a verde. Aceite ou reabra cada uma.

4. Só então execute o comando seguinte

   Quando a spec estiver certa, execute /speckit-plan e repita para o plano e as tarefas. Um erro apanhado na spec custa um comentário; apanhado no código, custa um retrabalho.

Verificar o tasks.md

A lista de tarefas é uma checklist Markdown, e o DotMD apresenta as listas de tarefas com as suas caixas, para ver de relance o que está feito e o que falta. Antes de executar /speckit-implement, leia as tarefas como o agente as vai ler: por ordem, cada uma pequena, nenhuma em falta. Se executou o passo de análise do Spec Kit, trate os seus resultados da mesma forma: abra-os no DotMD e comente aqueles com que não concorda.

Ligar o agente ao DotMD leva uma linha; os guias do Claude Code, do Codex e do Cursor mostram-na.

Porque rever cada ficheiro

O Spec Kit é rápido: um comando e aparece um documento inteiro. Essa rapidez é o risco. Se a spec tiver um requisito errado e executar o comando seguinte sem a ler, o plano e as tarefas assentam nele, e o código também. Ler spec.md com atenção uma vez é a verificação mais barata de todo o processo.

Perguntas sobre o Spec Kit

Mais perguntas