instgrameMCP

npx add-mcp 'https://connect.composio.dev/mcp'

English · 简体中文 · 日本語 · 한국어

Spec Kit é um kit de ferramentas de código aberto que dá aos agentes de codificação de IA processos estruturados, modelos reutilizáveis e resultados documentados. Comece com um processo pronto, personalize-o ou traga o seu próprio.

Escolha seu processo

O que você precisa	Processo	Resultado
Construir um recurso ou aplicação	Desenvolvimento orientado por especificação	Uma especificação conduzida por planejamento, implementação e convergência
Diagnosticar e reparar comportamento quebrado	Correção de bugs	Uma causa avaliada, correção escopada e verificação registrada
Decidir se uma ideia merece investimento	Avaliação de ideia	Uma decisão baseada em evidências: seguir, esclarecer ou parar
Adotar ou criar um processo diferente	Seu próprio processo	Um processo adaptado ou montado a partir de primitivas reutilizáveis

Estes são pontos de entrada independentes, não fases obrigatórias. O SDD vem incluído no núcleo; a correção de bugs e a avaliação são extensões agrupadas que você instala quando necessário, e as primitivas abaixo permitem adotar ou criar outros processos.

Capacidades

Spec Kit combina processos prontos para uso com mecanismos componíveis:

Capacidade	Mecanismo do Spec Kit
Conectar-se ou alternar entre agentes de codificação	Integração
Adicionar um comando, portão de qualidade ou processo completo	Extensão
Conectar um processo a uma ferramenta ou serviço externo	Extensão
Reagir a eventos do ciclo de vida do agente de codificação	Hook de evento de extensão
Adaptar modelos, comandos, terminologia ou metodologia	Predefinição
Aplicar padrões organizacionais ou regulatórios	Predefinição
Substituir um modelo para um projeto específico	Substituição local do projeto
Automatizar prompts, comandos, portões e tarefas de shell	Fluxo de trabalho
Modificar um fluxo de trabalho instalado sem bifurcá-lo	Sobreposição de fluxo de trabalho
Adicionar comportamento executável reutilizável a fluxos de trabalho	Etapa de fluxo de trabalho
Instalar uma configuração selecionada para um papel ou equipe	Pacote
Descobrir componentes da comunidade	Catálogo
Hospedar um catálogo privado de componentes aprovados	Catálogo
Acessar catálogos privados e downloads de componentes	Autenticação
Trabalhar offline ou atrás de um firewall	Fontes locais e catálogos auto-hospedados
Inspecionar qual camada fornece um comando, modelo ou script	Inventário de artefatos

Pesquise nos catálogos ativos com comandos como specify extension search, specify preset search, specify workflow search e specify bundle search. Spec Kit inclui catálogos da comunidade, e organizações podem adicionar suas próprias fontes selecionadas. As listagens de catálogo não são auditorias ou endossos, então revise o código-fonte da comunidade antes de instalá-lo ou executá-lo.

Comece

Você precisa de Python 3.11+, uv, e um agente de codificação de IA compatível em Linux, macOS ou Windows. Para configuração apenas via CLI, execute isto no seu terminal para instalar o Spec Kit e criar um projeto:

uv tool install specify-cli
specify init my-project --integration copilot
cd my-project

Os exemplos usam o modo de habilidades padrão do GitHub Copilot. Substitua copilot pela sua chave de integração para usar outro agente compatível.

Já tem código? Siga o guia para projetos existentes. Para versões fixadas, outros instaladores, CI ou solução de problemas, veja Instalação. Para atualizar uma instalação existente, veja Atualização.

Agora inicie seu agente de codificação no diretório do projeto e escolha um processo abaixo. Invoque cada habilidade /speckit-* no chat do seu agente, uma de cada vez, e revise o resultado antes de continuar. Estas são habilidades de agente, não comandos de terminal. Outros agentes e modos podem usar sintaxe de invocação diferente.

Desenvolvimento orientado por especificação

Defina o quê e por quê antes de decidir como construir. O SDD transforma seus requisitos em uma especificação, um plano técnico e tarefas acionáveis, e então orienta a implementação com base nesses artefatos.

Constituição uma vez por projeto; especificar → planejar → tarefas → implementar → convergir por recurso.

Invoque estas habilidades no chat do seu agente:

/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge

Repita implementar → convergir até que a convergência relate Convergido. Adicione esclarecimentos, listas de verificação e análise de consistência quando precisar de portões de qualidade extras.

Passo a passo do SDD · Referência de comandos

Correção de bugs

Mantenha diagnóstico, reparo e verificação separados para que o agente corrija a causa avaliada e verifique o sintoma original. Nenhum fluxo de trabalho de recurso SDD é necessário primeiro.

Configuração via CLI (terminal): instale a extensão opcional a partir do diretório do projeto:

specify extension add bug

Em seguida, invoque as habilidades avaliar → corrigir → testar no chat do seu agente:

/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash

Os relatórios ficam em .specify/bugs/login-crash/. Revise o veredito final: verified, partial ou failed. Verificação ausente não é uma correção bem-sucedida.

Passo a passo de correção de bugs · Referência de comandos

Avaliação de ideia

Reúna evidências antes de se comprometer com uma ideia, seja ela software ou não. Este processo independente funciona até mesmo em um projeto sem código-fonte.

Configuração via CLI (terminal): instale a extensão opcional a partir do diretório do projeto:

specify extension add assess

Em seguida, invoque as habilidades coleta → pesquisa → definir → modelar → decidir no chat do seu agente:

/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
/speckit-assess-research slug=offline-mode
/speckit-assess-define slug=offline-mode
/speckit-assess-shape slug=offline-mode
/speckit-assess-decide slug=offline-mode

Os artefatos ficam em .specify/assessments/offline-mode/, terminando em uma decisão seguir / precisa de esclarecimento / parar. Resolva incógnitas refinando os artefatos Markdown existentes diretamente ou com o agente, em vez de regenerar estágios inteiros. Uma decisão go pode ser entregue a /speckit-specify se você escolher construí-la; parar com um motivo documentado também é um resultado útil.

Passo a passo de avaliação · Referência de comandos

Personalize ou traga seu próprio processo

Extensões adicionam capacidades, predefinições adaptam o comportamento existente, fluxos de trabalho automatizam etapas e pacotes empacotam uma configuração baseada em papel. Use substituições locais do projeto para mudanças pontuais de modelo.

Guia de personalização · Extensões, predefinições, pacotes e passo a passos da comunidade

Documentação

• Referência da CLI e comandos de processo
• Filosofia do SDD, metodologia completa e evoluindo especificações existentes
• Visão geral em vídeo e histórico do projeto
• Como o Spec Kit usa o Spec Kit

Histórico de estrelas

Obrigado a todos que ajudam o Spec Kit a brilhar.

Suporte e contribuição

Relatar um bug ou solicitar um recurso · Guia de contribuição · Código de conduta

Spec Kit é licenciado sob MIT.