Regras personalizadas influenciam como Bob responde às suas solicitações, alinhando a saída com suas preferências específicas e requisitos do projeto. Configure regras personalizadas para controlar o estilo de codificação, a abordagem de documentação e os processos de tomada de decisão do Bob.

O que são regras personalizadas?

Regras personalizadas estendem o comportamento padrão do Bob definindo preferências, restrições e diretrizes que direcionam como Bob aborda tarefas para corresponder às suas necessidades.

Usos comuns incluem:

Preferências de estilo de codificação (indentação, convenções de nomenclatura)

Formatos e padrões de documentação

Metodologias e requisitos de teste

Fluxos de trabalho e processos de projeto

Convenções específicas da equipe

Adicionando regras personalizadas para um modo

Você pode adicionar regras personalizadas aos modos de duas maneiras:

Através da interface do usuário

Configure regras que se aplicam a todos os seus projetos:

Clique nos três pontos no canto superior direito da barra lateral Bob.

Clique em Modos.

Selecione o modo para o qual você quer editar regras.

Clique em Editar.

Role até Instruções personalizadas específicas do modo (opcional).

Digite suas regras.

Clique em Salvar.

Através de arquivos de regras específicos do modo

Os modos também podem ter arquivos de regras adicionais armazenados em diretórios sob .bob/rules-{mode-slug}/:

01-style-guide.md

02-formatting.txt

Os arquivos no diretório são carregados alfabeticamente e combinados com a propriedade customInstructions da sua configuração de modo. Para mais detalhes, consulte Modos personalizados.

Saiba mais sobre padronizar o comportamento do Bob usando regras em nível de projeto.

Escopos de regras

Bob suporta dois escopos de regras que determinam onde suas regras se aplicam:

Regras globais: Aplicam-se automaticamente em todos os seus projetos

Regras de espaço de trabalho: Aplicam-se apenas dentro do seu projeto atual

Use regras globais para padrões pessoais ou de toda a organização. Use regras de espaço de trabalho para requisitos específicos do projeto.

Métodos de configuração

Configuração baseada em diretório

Use diretórios sob .bob/ na raiz do seu espaço de trabalho:

Estrutura do espaço de trabalho:

coding-style.md

typescript.md

rules/ - Regras gerais para todos os modos

rules-agent/ - Regras específicas do modo Agent

Estrutura global:

Linux/macOS: ~/.bob/rules/ Windows: %USERPROFILE%\.bob\rules\

Crie regras de espaço de trabalho:

mkdir -p .bob/rules
echo "# Padrões do projeto" > .bob/rules/coding-style.md

Crie regras globais:

# Linux/macOS
mkdir -p ~/.bob/rules
echo "# Padrões globais" > ~/.bob/rules/coding-standards.md

# Windows
mkdir %USERPROFILE%\.bob\rules
echo # Padrões globais > %USERPROFILE%\.bob\rules\coding-standards.md

Prioridade de regras

Bob combina regras de múltiplas fontes nesta ordem:

Regras globais (~/.bob/rules/)

Regras de espaço de trabalho (.bob/rules/)

Dentro de cada nível, regras específicas do modo carregam antes das regras gerais. Regras de espaço de trabalho podem substituir regras globais.

Escrevendo regras eficazes

Seja específico e acionável

Bom: "Use 4 espaços para indentação em arquivos JavaScript"

Evite: "Formate o código bem"

Use estrutura clara

Organize regras por tópico:

# Estilo de Código
- Use camelCase para variáveis
- Use PascalCase para classes

# Testes
- Escreva testes unitários para todas as funções públicas
- Use Jest como framework de teste

# Documentação
- Adicione comentários JSDoc para APIs públicas

Exemplos de regras eficazes

"Sempre use espaços para indentação, com largura de 4 espaços"

"Use camelCase para nomes de variáveis"

"Escreva testes unitários para todas as novas funções"

"Explique seu raciocínio antes de fornecer código"

"Ao adicionar recursos a sites, garanta que sejam responsivos e acessíveis"

Configuração avançada

Regras específicas do modo

Direcione modos específicos com diretórios dedicados:

Diretório	Propósito
`rules/`	Regras gerais para todos os modos
`rules-agent/`	Apenas modo Agent
`rules-plan/`	Apenas modo Plan
`rules-ask/`	Apenas modo Ask
`rules-{mode}/`	Qualquer modo personalizado

Usando arquivos `AGENTS.md`

Para padronização de equipe, você pode usar um arquivo AGENTS.md na raiz do seu espaço de trabalho:

# Padrões da Equipe
- Siga as diretrizes de codificação da empresa
- Use apenas bibliotecas aprovadas
- Documente todas as mudanças de API

Detalhes principais:

Carregado automaticamente por padrão

Controle de versão com seu projeto

Desabilite com "bob-code.useAgentRules": false nas configurações

Carregado após regras específicas do modo, mas antes das regras gerais do espaço de trabalho

Comportamento de arquivo

Leitura recursiva: Bob lê todos os arquivos em diretórios de regras, incluindo subdiretórios

Ordem alfabética: Arquivos processam em ordem alfabética por nome de arquivo

Filtragem automática: Exclui arquivos de cache (.DS_Store, *.bak, *.cache, *.log, *.tmp, Thumbs.db)

Links simbólicos: Suportados com profundidade máxima de 5

Arquivos vazios: Silenciosamente ignorados

Padronização de equipe

Padrões em nível de projeto

Use diretórios .bob/rules/ de espaço de trabalho sob controle de versão:

# Adicionar ao controle de versão
git add .bob/rules/
git commit -m "Adicionar regras personalizadas Bob"

Isso garante comportamento consistente entre membros da equipe para projetos específicos.

Padrões de toda a organização

Distribua regras globais para membros da equipe:

Crie um repositório de regras compartilhado

Membros da equipe clonam para ~/.bob/rules/

Atualize periodicamente para consistência

Abordagem híbrida

Você pode combinar ambas as abordagens:

Regras globais para padrões da organização

Regras de espaço de trabalho para requisitos específicos do projeto

Regras de espaço de trabalho substituem regras globais quando necessário

Regras personalizadas

Nesta página