Introdução geral

O RooFlow é uma ferramenta de programação assistida por IA de código aberto com a função principal de preservar o código, as decisões e o progresso das tarefas durante o desenvolvimento por meio do registro de projetos. Ela é baseada emCódigo RooA extensão integra cinco modos: arquitetura, codificação, teste, depuração e perguntas e respostas. Esses modos colaboram entre si para ajudar os desenvolvedores a alternar perfeitamente entre as tarefas em um projeto e salvar automaticamente as informações relevantes. O RooFlow oferece suporte à personalização profunda dos comportamentos de IA por meio do recurso Footgun, ao mesmo tempo em que otimiza o uso de tokens e reduz os custos. Ele é adequado para programadores que precisam de gerenciamento de projetos de longo prazo e desenvolvimento eficiente. O projeto é de código aberto no GitHub, com uma comunidade ativa e atualizações contínuas para o ambiente VS Code.

Lista de funções

• Registros de projetos Salvar automaticamente o código, as decisões e o progresso da tarefa, armazenando-os na pastamemory-bankpara dar suporte à consistência entre as sessões.
• Cinco modos de colaboração ::
  • Modelo de arquitetura: planejamento da estrutura do projeto, geração deprojectBrief.mdetc.
  • Modo de codificação: ajuda a escrever códigos e a documentar o processo de codificação.
  • Modo de teste: gere casos de teste e gerencie o processo de teste.
  • Modo de depuração: analisa erros de código e fornece sugestões para corrigi-los.
  • Modo de perguntas e respostas: responda a perguntas sobre desenvolvimento e forneça respostas relevantes em conjunto com os registros do projeto.
• Personalização do revólver Suporte para que os usuários ajustem o comportamento da IA e modifiquem as palavras-chave do padrão para atender a necessidades específicas.
• Uso eficiente de tokens Otimização do design de palavras-chave para reduzir o consumo de tokens em interações de IA e reduzir custos.
• atualização em tempo real Atualize automaticamente os registros do projeto com base em eventos importantes no modelo para manter as informações atualizadas.
• Rastreamento de tarefas Gera uma lista de tarefas, registra itens concluídos e pendentes, armazena os itens concluídos e pendentes e armazena os itens pendentes.progress.md.
• Suporte MCP Funcionalidade expandida conectando-se a servidores locais ou remotos por meio de protocolos de contexto de modelo.
• Modo padrão e coordenado Modo padrão global e modo de coordenação para gerenciar tarefas complexas.

Usando a Ajuda

Processo de instalação

O RooFlow depende da extensão Roo Code, que precisa ser instalada no ambiente do VS Code. Veja a seguir as etapas detalhadas:

1. Preparação do ambiente ::
   • Instale as extensões VS Code e Roo Code.
   • Verifique se o sistema está instaladogitque pode ser baixado do site git-scm.com.
   • Certifique-se de que o diretório do projeto esteja vazio ou inicializado; é recomendável incluir o diretório.rooé usada para armazenar a configuração.
2. Faça o download e instale o script ::
   • Abra um terminal e mude para o diretório raiz do projeto (cd 项目路径).
   • Faça o download do script:
     • Windows (Prompt de Comando ou PowerShell):

       curl -L -o install_rooflow.cmd https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow.cmd
       

     • Linux/macOS (bash/zsh):

       curl -L -o install_rooflow.sh https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow.sh
       

3. Execute o script de instalação ::
   • Windows:

     .\install_rooflow.cmd
     

   • Linux/macOS:

     chmod +x install_rooflow.sh && ./install_rooflow.sh
     

   • O script verificará ogitdisponibilidade, faça o download do repositório do RooFlow, mova o arquivo de configuração para o diretório.rooinjetar o caminho do espaço de trabalho e excluir automaticamente os arquivos temporários.
4. Verificar a instalação ::
   • Verifique se o diretório raiz do projeto contém.roopastas e.roomodesDocumentação.
   • show (um ingresso).roo/system-prompt-*Documentação, reconhecimentoWORKSPACE_PLACEHOLDERfoi substituído pelo caminho real.
   • Execute o comando Roo Code no VS Code para verificar se os cinco modos estão disponíveis.
5. Instalação do modo padrão e coordenado (Opcional):
   • Abra a interface Roo Code do VS Code e clique no ícone "Prompts" (ícone de livro).
   • Clique em "+" na seção "Modes" (Modos) para adicionar um novo modo.
   • Digite o nome do modo (DefaulttalvezCoordinatorSe quiser salvar o arquivo, selecione "Global" para armazená-lo.
   • Preencha as definições de função e os comandos personalizados:
     • Definição de função de modo padrão:

       A custom, global mode in Roo Code, using the Roo Code default rules and instructions, along with the custom instruction set for memory bank functionality. Typically called upon when a functionality is not working correctly with the other custom modes. You should have a very broad range of knowledge and abilities.
       

     • Definição da função do modelo de coordenação:

       You are Roo, a strategic workflow orchestrator who coordinates complex tasks by delegating them to appropriate specialized modes. You have a comprehensive understanding of each mode's capabilities and limitations, allowing you to effectively break down complex problems into discrete tasks that can be solved by different specialists.
       

   • Clique em "Create Mode" para salvar.

Atualizando o RooFlow

• A nova execução do script de instalação substitui.roopastas e.roomodesatualizado para a versão mais recente.

Uso das funções principais

No centro do RooFlow está o registro do projeto e os cinco modos. Aqui está um guia detalhado de como fazer isso:

Registros de projetos

• inicialização ::
  • Na tela de bate-papo do Roo Code, digiteActivate Memory Bank.
  • Se o projeto não tivermemory-banko sistema alterna para o modo de arquitetura para iniciar a inicialização e gerar o arquivoactiveContext.mdedecisionLog.mdeproductContext.mdeprogress.mdetc.
• atualização ::
  • entradaUpdate Memory BanktalvezUMBsincroniza as informações da sessão atual com o registro do projeto.
• confira ::
  • show (um ingresso)memory-bankexiba o diretórioprogress.md(Lista de tarefas),decisionLog.md(Registro de Decisão), etc.
• tomar nota de Registros de projetos são gerenciados automaticamente sem a necessidade de edição manual, mas os arquivos podem ser inspecionados quanto ao conteúdo do registro de IA.

Cinco modelos

1. Modelo de arquitetura ::
   • Entrada:

     new_task:
     mode: architect
     message: |
     规划一个Web应用的项目结构
     

   • O sistema gera a estrutura do projeto e a salva na pastaprojectBrief.md.
2. modo de codificação ::
   • Entrada:

     new_task:
     mode: code
     message: |
     编写一个Python函数处理JSON数据
     

   • Gerar código para registrar nomemory-bank/activeContext.md.
3. padrão de teste ::
   • Entrada:

     new_task:
     mode: test
     message: |
     为Python函数生成单元测试
     

   • Gere casos de teste e salve-os no arquivomemory-bank/test.md.
4. modo de depuração ::
   • Entrada:

     new_task:
     mode: debug
     message: |
     修复Python函数中的KeyError
     

   • Fornecer recomendações de correções, documentadas paradecisionLog.md.
5. modo de perguntas e respostas ::
   • Entrada:

     new_task:
     mode: ask
     message: |
     如何优化Python循环性能？
     

   • Responda, em conjunto com o registro do projeto, às perguntas apropriadas ao projeto.

Personalização do revólver

• compilador.roo/system-prompt-*Documentação para ajustar o comportamento do modelo.
• Exemplo: Modificaçãosystem-prompt-code::

  优先使用函数式编程，代码风格遵循PEP 8。
  

• Adicionar um novo modelo:
  • modificaçõesmodules/modes.ymladicione uma nova definição de esquema.
  • atualizaçãorooflow_core_prompt.yamlresponder cantandosystem-prompt-[新模式]Aderirmemory_bank_strategy.yml.
  • existir.roomodesAdicionar uma nova entrada de modo.
• avisos Modificações no Footgun podem causar um comportamento anormal da IA; recomenda-se fazer um backup!.rooPasta.

Suporte MCP

• existirsystem-prompt-[mode](usado em uma expressão nominal)MCP_SERVERS_PLACEHOLDERAdicionar configuração do servidor:
  • Local: use entradas/saídas padrão.
  • Remoto: use eventos de servidor HTTP/HTTPS (SSE).
• Exemplo:

  MCP_SERVERS: http://example.com/mcp
  

Modo padrão e coordenado

• Modo padrão: Use os prompts padrão do Roo Code, adequados para quando os outros modos falharem.
• Modelo de coordenação: gerencia tarefas complexas, divide os problemas e os atribui a outros modelos.
• Selecione o modo na tela Roo Code e entre diretamente na tarefa.

advertência

• O RooFlow substitui completamente as palavras de prompt do Roo Code, o que pode afetar a função original, portanto, é recomendável experimentá-lo em um projeto de teste.
• Excluir se o comportamento da IA for anormal.rooinstale o Roo Code Memory Bank para restaurar os prompts padrão.
• Verifique regularmente se há atualizações do repositório do GitHub e execute o script de instalação para mantê-lo atualizado.

cenário do aplicativo

1. Desenvolvimento de projetos de longo prazo
   Os desenvolvedores precisam manter registros em projetos complexos, e os registros de projeto do RooFlow mantêm códigos, decisões e tarefas para o desenvolvimento entre sessões.
2. Trabalho em equipe
   Compartilhamento de equipememory-bankPastas para acesso rápido ao andamento do projeto e às decisões arquitetônicas para uma colaboração mais eficiente.
3. Prototipagem rápida
   Prototipagem rápida de projetos usando cinco padrões para iniciantes que estão aprendendo a codificar, testar e depurar.
4. Desenvolvimento de IA de baixo custo
   Otimize o uso de tokens e reduza o custo das chamadas de IA para desenvolvedores independentes com orçamentos limitados.
5. Processo de desenvolvimento personalizado
   Adapte o comportamento da IA às necessidades específicas do projeto, como um determinado estilo de codificação ou estratégia de teste, com o recurso Footgun.

QA

1. Qual é a diferença entre o RooFlow e o Roo Code Memory Bank?
   O RooFlow aprimora o Roo Code Memory Bank, acrescentando a personalização do Footgun, o uso otimizado de tokens e cinco modos de colaboração para simplificar a instalação e as atualizações em tempo real.
2. Como resolver o problema de falha na instalação?
   sondagite a conexão de rede, verifique se a extensão Roo Code está instalada. Se isso falhar, remova a extensão.rooe execute o script novamente.
3. O recurso Footgun é seguro?
   O Footgun oferece suporte à personalização profunda, mas pode resultar em um comportamento anormal da IA. Recomenda-se fazer backup do arquivo de configuração e modificá-lo com cuidado.
4. Como faço para adicionar um novo modelo?
   modificaçõesmodes.ymlresponder cantandorooflow_core_prompt.yamlAtualizaçõessystem-prompt-[新模式]em.roomodesPara adicionar uma entrada, consulte os módulos.
5. Como faço para contribuir com o código?
   Visite o repositório do GitHub, envie uma Pull Request, siga as instruçõesCONTRIBUTING.mdGuia.