Transforme ideias em código com sessões de propostas
Editar páginaAs sessões de propostas são o ponto de entrada certo quando uma solicitação é muito importante para ser tratada como um único prompt de formato livre. Em vez de editar imediatamente, o HagiCode primeiro transforma a solicitação em metas, escopo, tarefas e critérios de validação e depois passa para a execução.
Pré-requisitos
Seção intitulada “Pré-requisitos”Antes de iniciar uma sessão de proposta, certifique-se de ter:
- concluído Instalação na área de trabalho
- concluído Configuração do assistente e criou pelo menos um projeto
- contexto de projeto suficiente para descrever a mudança; se não, comece com Crie uma sessão de conversa
Para que servem as sessões de propostas
Seção intitulada “Para que servem as sessões de propostas”As sessões de propostas funcionam melhor quando:
- a mudança precisa de um escopo claro antes do início da edição
- vários repositórios, módulos ou entregas estão envolvidos
- o trabalho deve ser dividido em etapas revisáveis
- você deseja que a trilha de raciocínio e execução permaneça visível mais tarde
Se você precisar apenas de compreensão do repositório ou de uma discussão leve, uma sessão de conversação será mais rápida. Se precisar de estrutura e rastreabilidade, continue aqui.
Visão geral do fluxo de trabalho
Seção intitulada “Visão geral do fluxo de trabalho”O fluxo de proposta atual pode ser resumido assim:
| Palco | Ação do usuário | Resultado do sistema |
|---|---|---|
| Crie a proposta | Abra o New Idea gaveta e descreva o pedido | A proposta começa com o escopo explícito do projeto e do repositório |
| Confirme a estrutura | Revise a visualização de detalhes da sessão e o estado do fluxo de trabalho | A IA explica metas, etapas e status antes de uma execução mais profunda |
| Acompanhe o progresso | Use o quadro de sessão para monitorar itens pendentes, ativos e arquivados | Várias propostas ficam mais fáceis de gerenciar |
| Revise o resultado | Retornar à visualização da sessão concluída | Você pode reutilizar notas de commit e histórico de sessão em vez de começar de novo |
Passo 1: Defina a mudança no New Idea gaveta
Seção intitulada “Passo 1: Defina a mudança no New Idea gaveta”O actual ponto de entrada da proposta é o New Idea gaveta. Faz mais do que aceitar uma solicitação de texto curto. Também força a solicitação a um projeto concreto e a um escopo de repositório.
Comece revisando estas áreas:
- seletor de projetos: confirme qual projeto possui a solicitação
- escopo do repositório: escolha quais repositórios estão dentro dos limites
- área de visualização: verifique o que o sistema tratará como escopo alvo
- caixa de solicitação: descreva a mudança real na linguagem natural
Se o trabalho envolver documentos, front-end e back-end juntos, defina esse limite aqui em vez de adicioná-lo posteriormente durante a execução.
Etapa 2: revisar metas, etapas e status na visualização detalhada da proposta
Seção intitulada “Etapa 2: revisar metas, etapas e status na visualização detalhada da proposta”Após a criação, o HagiCode não vai direto para a edição. Primeiro, ele abre uma visualização detalhada que mantém o estado do fluxo de trabalho, o conteúdo da proposta e o contexto da sessão juntos.
Esta tela mostra por que as sessões de proposta são diferentes das sessões normais de conversação:
- o painel central não é apenas um bate-papo; mantém visível o conteúdo relacionado à proposta
- o passo a passo do fluxo de trabalho torna o estado atual explícito
- a lista de sessões e a área de detalhes preservam o contexto para trabalhos de longa duração
Se a meta, o escopo ou a divisão da tarefa ainda parecerem errados aqui, corrija a proposta antes de prosseguir. Esse é o objetivo deste fluxo de trabalho.
Etapa 3: acompanhar diversas propostas no quadro da sessão
Seção intitulada “Etapa 3: acompanhar diversas propostas no quadro da sessão”Quando um projeto tem diversas propostas, diversas rodadas de execução ou uma combinação de trabalhos pendentes e concluídos, o quadro da sessão se torna a visão geral mais clara.
Essa visualização é especialmente útil para três coisas:
- identificar quais propostas ainda não começaram
- comparando o ritmo de múltiplas sessões ativas
- arquivar o trabalho concluído para que o espaço de trabalho permaneça legível
Se o seu fluxo diário envolve vários threads paralelos, a visualização do quadro geralmente é melhor do que abrir uma visualização detalhada por vez.
Etapa 4: revisitar o estado de execução finalizado
Seção intitulada “Etapa 4: revisitar o estado de execução finalizado”Ao final de uma proposta, geralmente você precisa de mais do que um simples marcador “pronto”. Você também precisa revisar o que mudou, como o resumo do commit foi organizado e se o mesmo contexto pode continuar na próxima rodada.
Esta visualização de estado concluído é útil para duas tarefas de acompanhamento:
- revisando as notas de commit geradas e o principal resultado da execução
- continuando a partir do mesmo contexto de sessão em vez de reconstruir tudo do zero
Em outras palavras, uma sessão de propostas não é um gerador único. É um registro de fluxo de trabalho durável.
Quando preferir uma sessão de proposta
Seção intitulada “Quando preferir uma sessão de proposta”Escolha uma sessão de proposta primeiro quando:
- a mudança é complexa e você não quer que a IA improvise muito cedo
- o trabalho será revisado ou compartilhado com outras pessoas posteriormente
- vários repositórios, módulos ou funções estão envolvidos
- você deseja que o histórico de execução e a lógica permaneçam reutilizáveis
Se a tarefa ainda for pequena e exploratória, uma sessão de conversa costuma ser o caminho mais leve.