Skip to content

Latest commit

 

History

History
990 lines (729 loc) · 24.5 KB

File metadata and controls

990 lines (729 loc) · 24.5 KB

Referência de Comandos do Meta-Agente

🌐 EN | PT | ES


Guia de referência completo para todos os comandos do meta-agente Synkra AIOX.

Sumário

  1. Sintaxe de Comandos
  2. Comandos Principais
  3. Gerenciamento de Agentes
  4. Operações de Tarefas
  5. Comandos de Workflow
  6. Geração de Código
  7. Análise e Melhoria
  8. Camada de Memória
  9. Auto-Modificação
  10. Comandos do Sistema
  11. Comandos Avançados

Sintaxe de Comandos

Todos os comandos do meta-agente seguem este padrão:

*command-name [required-param] [--optional-flag value]
  • Comandos começam com * (asterisco)
  • Parâmetros em [] são obrigatórios
  • Flags começam com -- e podem ter valores
  • Múltiplas flags podem ser combinadas

Exemplos

*create-agent my-agent
*analyze-code src/app.js --depth full
*generate-tests --type unit --coverage 80

Comandos Principais

*help

Exibe todos os comandos disponíveis ou obtém ajuda para um comando específico.

*help                    # Mostra todos os comandos
*help create-agent       # Ajuda para comando específico
*help --category agents  # Comandos por categoria

*status

Mostra o status atual do sistema e agentes ativos.

*status                  # Status básico
*status --detailed       # Informações detalhadas do sistema
*status --health        # Resultados de verificação de saúde

*config

Visualiza ou modifica configuração.

*config                  # Ver configuração atual
*config --set ai.model gpt-4      # Definir valor de configuração
*config --reset         # Restaurar padrões
*config --export        # Exportar configuração

*version

Exibe informações de versão.

*version                # Versão atual
*version --check-update # Verificar atualizações
*version --changelog    # Mostrar changelog

Gerenciamento de Agentes

*create-agent

Cria um novo agente de IA.

*create-agent <name> [options]

Options:
  --type <type>         Tipo de agente: assistant, analyzer, generator, specialist
  --template <name>     Usar template: basic, advanced, custom
  --capabilities        Construtor interativo de capacidades
  --from-file <path>    Criar a partir de definição YAML

Exemplos:
*create-agent code-reviewer --type analyzer
*create-agent api-builder --template advanced
*create-agent custom-bot --from-file agents/template.yaml

*list-agents

Lista todos os agentes disponíveis.

*list-agents                      # Lista todos os agentes
*list-agents --active            # Apenas agentes ativos
*list-agents --type analyzer     # Filtrar por tipo
*list-agents --detailed          # Mostrar detalhes completos

*activate

Ativa um agente para uso.

*activate <agent-name>            # Ativar um único agente
*activate agent1 agent2          # Ativar múltiplos
*activate --all                  # Ativar todos os agentes
*activate --type assistant       # Ativar por tipo

*deactivate

Desativa um agente.

*deactivate <agent-name>         # Desativar um único agente
*deactivate --all               # Desativar todos os agentes
*deactivate --except agent1     # Desativar todos exceto o especificado

*modify-agent

Modifica configuração de agente existente.

*modify-agent <name> [options]

Options:
  --add-capability <name>        Adicionar nova capacidade
  --remove-capability <name>     Remover capacidade
  --update-instructions         Atualizar instruções
  --version <version>           Atualizar versão
  --interactive                 Modificação interativa

Exemplos:
*modify-agent helper --add-capability translate
*modify-agent analyzer --update-instructions
*modify-agent bot --interactive

*delete-agent

Remove um agente (com confirmação).

*delete-agent <name>            # Deletar um único agente
*delete-agent --force          # Pular confirmação
*delete-agent --backup         # Criar backup antes da exclusão

*clone-agent

Cria uma cópia de um agente existente.

*clone-agent <source> <target>  # Clone básico
*clone-agent bot bot-v2 --modify  # Clonar e modificar

Operações de Tarefas

*create-task

Cria uma nova tarefa reutilizável.

*create-task <name> [options]

Options:
  --type <type>           Tipo de tarefa: command, automation, analysis
  --description <text>    Descrição da tarefa
  --parameters           Definir parâmetros interativamente
  --template <name>      Usar template de tarefa

Exemplos:
*create-task validate-input --type command
*create-task daily-backup --type automation
*create-task code-metrics --template analyzer

*list-tasks

Lista tarefas disponíveis.

*list-tasks                     # Lista todas as tarefas
*list-tasks --type automation  # Filtrar por tipo
*list-tasks --recent          # Tarefas usadas recentemente
*list-tasks --search <query>  # Buscar tarefas

*run-task

Executa uma tarefa específica.

*run-task <task-name> [params]

Exemplos:
*run-task validate-input --data "user input"
*run-task generate-report --format pdf
*run-task backup-database --incremental

*schedule-task

Agenda execução de tarefa.

*schedule-task <task> <schedule>

Formatos de agendamento:
  --cron "0 0 * * *"           Expressão cron
  --every "1 hour"             Intervalo
  --at "14:30"                 Horário específico
  --on "monday,friday"         Dias específicos

Exemplos:
*schedule-task cleanup --cron "0 2 * * *"
*schedule-task report --every "6 hours"
*schedule-task backup --at "03:00" --on "sunday"

*modify-task

Atualiza configuração de tarefa.

*modify-task <name> [options]

Options:
  --add-param <name>           Adicionar parâmetro
  --update-logic              Atualizar implementação
  --change-type <type>        Alterar tipo de tarefa
  --rename <new-name>         Renomear tarefa

Comandos de Workflow

*create-workflow

Cria workflow automatizado.

*create-workflow <name> [options]

Options:
  --steps                Construtor interativo de etapas
  --trigger <type>      Tipo de gatilho: manual, schedule, event
  --template <name>     Usar template de workflow
  --from-file <path>    Importar de YAML

Exemplos:
*create-workflow ci-pipeline --trigger push
*create-workflow daily-tasks --trigger "schedule:0 9 * * *"
*create-workflow deployment --template standard-deploy

*list-workflows

Exibe workflows disponíveis.

*list-workflows                 # Todos os workflows
*list-workflows --active       # Em execução atualmente
*list-workflows --scheduled    # Workflows agendados
*list-workflows --failed       # Execuções com falha

*run-workflow

Executa um workflow.

*run-workflow <name> [options]

Options:
  --params <json>             Parâmetros do workflow
  --skip-steps <steps>        Pular etapas específicas
  --dry-run                   Visualizar sem executar
  --force                     Forçar execução mesmo se em andamento

Exemplos:
*run-workflow deploy --params '{"env":"staging"}'
*run-workflow backup --skip-steps "upload"
*run-workflow test-suite --dry-run

*stop-workflow

Para workflow em execução.

*stop-workflow <name>          # Parar workflow específico
*stop-workflow --all          # Parar todos os workflows
*stop-workflow --force        # Forçar parada

*workflow-status

Verifica status de execução do workflow.

*workflow-status <name>        # Status de um único workflow
*workflow-status --all        # Status de todos os workflows
*workflow-status --history    # Histórico de execução

Geração de Código

*generate-component

Gera novos componentes com assistência de IA.

*generate-component <name> [options]

Options:
  --type <type>              Tipo de componente: react, vue, angular, web-component
  --features <list>          Funcionalidades do componente
  --style <type>             Estilização: css, scss, styled-components
  --tests                    Gerar testes
  --storybook               Gerar stories do Storybook
  --template <name>         Usar template de componente

Exemplos:
*generate-component UserProfile --type react --features "avatar,bio,stats"
*generate-component DataTable --type vue --tests --storybook
*generate-component CustomButton --template material-ui

*generate-api

Gera endpoints de API.

*generate-api <resource> [options]

Options:
  --operations <list>        Operações CRUD: create,read,update,delete
  --auth                     Adicionar autenticação
  --validation              Adicionar validação de entrada
  --docs                    Gerar documentação da API
  --tests                   Gerar testes de API
  --database <type>         Tipo de banco de dados: postgres, mongodb, mysql

Exemplos:
*generate-api users --operations crud --auth --validation
*generate-api products --database mongodb --docs
*generate-api analytics --operations "read" --tests

*generate-tests

Gera suítes de testes.

*generate-tests [target] [options]

Options:
  --type <type>             Tipo de teste: unit, integration, e2e
  --framework <name>        Framework de teste: jest, mocha, cypress
  --coverage <percent>      Porcentagem de cobertura alvo
  --mocks                   Gerar dados mock
  --fixtures               Gerar fixtures de teste

Exemplos:
*generate-tests src/utils/ --type unit --coverage 90
*generate-tests src/api/ --type integration --mocks
*generate-tests --type e2e --framework cypress

*generate-documentation

Gera documentação.

*generate-documentation [target] [options]

Options:
  --format <type>           Formato: markdown, html, pdf
  --type <type>            Tipo de documentação: api, user-guide, technical
  --include-examples       Adicionar exemplos de código
  --diagrams              Gerar diagramas
  --toc                   Gerar sumário

Exemplos:
*generate-documentation src/ --type api --format markdown
*generate-documentation --type user-guide --include-examples
*generate-documentation components/ --diagrams --toc

Análise e Melhoria

*analyze-framework

Analisa todo o codebase.

*analyze-framework [options]

Options:
  --depth <level>          Profundidade de análise: surface, standard, deep
  --focus <areas>          Áreas de foco: performance, security, quality
  --report-format <type>   Formato: console, json, html
  --save-report <path>     Salvar relatório de análise
  --compare-previous      Comparar com análise anterior

Exemplos:
*analyze-framework --depth deep
*analyze-framework --focus "performance,security"
*analyze-framework --save-report reports/analysis.json

*analyze-code

Analisa arquivos de código específicos.

*analyze-code <path> [options]

Options:
  --metrics               Mostrar métricas de código
  --complexity           Analisar complexidade
  --dependencies         Analisar dependências
  --suggestions          Obter sugestões de melhoria
  --security             Análise de segurança

Exemplos:
*analyze-code src/app.js --metrics --complexity
*analyze-code src/api/ --security --suggestions
*analyze-code package.json --dependencies

*improve-code-quality

Melhora qualidade do código com assistência de IA.

*improve-code-quality <path> [options]

Options:
  --focus <aspects>        Foco: readability, performance, maintainability
  --refactor-level <level> Nível: minor, moderate, major
  --preserve-logic        Não alterar funcionalidade
  --add-comments          Adicionar comentários explicativos
  --fix-eslint           Corrigir problemas de linting

Exemplos:
*improve-code-quality src/utils.js --focus readability
*improve-code-quality src/legacy/ --refactor-level major
*improve-code-quality src/api.js --fix-eslint --add-comments

*suggest-refactoring

Obtém sugestões de refatoração.

*suggest-refactoring <path> [options]

Options:
  --type <type>           Tipo de refatoração: extract, inline, rename
  --scope <level>         Escopo: function, class, module, project
  --impact-analysis      Mostrar impacto das mudanças
  --preview              Visualizar mudanças
  --auto-apply          Aplicar sugestões automaticamente

Exemplos:
*suggest-refactoring src/helpers.js --type extract
*suggest-refactoring src/models/ --scope module
*suggest-refactoring src/app.js --preview --impact-analysis

*detect-patterns

Detecta padrões e anti-padrões de código.

*detect-patterns [path] [options]

Options:
  --patterns <list>       Padrões específicos para detectar
  --anti-patterns        Focar em anti-padrões
  --suggest-fixes        Sugerir melhorias de padrões
  --severity <level>     Severidade mínima: low, medium, high

Exemplos:
*detect-patterns --anti-patterns --suggest-fixes
*detect-patterns src/ --patterns "singleton,factory"
*detect-patterns --severity high

Camada de Memória

*memory

Operações da camada de memória.

*memory <operation> [options]

Operações:
  status                 Mostrar status da camada de memória
  search <query>        Busca semântica
  rebuild               Reconstruir índice de memória
  clear-cache          Limpar cache de memória
  optimize             Otimizar desempenho da memória
  export <path>        Exportar dados de memória
  import <path>        Importar dados de memória

Exemplos:
*memory status
*memory search "authentication flow"
*memory rebuild --verbose
*memory optimize --aggressive

*learn

Aprende com mudanças e padrões de código.

*learn [options]

Options:
  --from <source>         Fonte: recent-changes, commits, patterns
  --period <time>         Período: "1 week", "1 month"
  --focus <areas>         Áreas de foco para aprendizado
  --update-patterns      Atualizar reconhecimento de padrões
  --save-insights        Salvar insights de aprendizado

Exemplos:
*learn --from recent-changes
*learn --from commits --period "1 week"
*learn --focus "error-handling,api-calls"

*remember

Armazena informações importantes na memória.

*remember <key> <value> [options]

Options:
  --type <type>          Tipo de informação: pattern, preference, rule
  --context <context>    Contexto para a memória
  --expires <time>       Tempo de expiração
  --priority <level>     Prioridade: low, normal, high

Exemplos:
*remember coding-style "use-functional-components" --type preference
*remember api-pattern "always-validate-input" --context security
*remember temp-fix "skip-test-x" --expires "1 week"

*forget

Remove informação da memória.

*forget <key>              # Esquecer chave específica
*forget --pattern <regex>  # Esquecer por padrão
*forget --older-than <time> # Esquecer memórias antigas
*forget --type <type>      # Esquecer por tipo

Auto-Modificação

*improve-self

Auto-melhoria do meta-agente.

*improve-self [options]

Options:
  --aspect <area>         Área de melhoria: speed, accuracy, features
  --based-on <data>      Baseado em: usage, feedback, analysis
  --preview              Visualizar melhorias
  --backup              Criar backup antes das mudanças
  --test-improvements   Testar melhorias antes de aplicar

Exemplos:
*improve-self --aspect accuracy --based-on feedback
*improve-self --preview --test-improvements
*improve-self --aspect features --backup

*evolve

Evolui capacidades baseado no uso.

*evolve [options]

Options:
  --strategy <type>      Estratégia de evolução: conservative, balanced, aggressive
  --focus <areas>        Áreas de foco para evolução
  --generations <num>    Número de ciclos de evolução
  --fitness-metric      Definir métricas de aptidão
  --rollback-point     Criar ponto de rollback

Exemplos:
*evolve --strategy balanced
*evolve --focus "code-generation,analysis" --generations 3
*evolve --fitness-metric "task-success-rate" --rollback-point

*adapt

Adapta às necessidades específicas do projeto.

*adapt [options]

Options:
  --to <context>         Adaptar a: project-type, team-style, domain
  --learn-from <source>  Aprender de: codebase, commits, reviews
  --adaptation-level     Nível: minimal, moderate, full
  --preserve <aspects>   Preservar comportamentos específicos

Exemplos:
*adapt --to project-type --learn-from codebase
*adapt --to team-style --adaptation-level moderate
*adapt --to domain --preserve "core-functions"

*optimize-performance

Otimiza desempenho do meta-agente.

*optimize-performance [options]

Options:
  --target <metric>      Alvo: speed, memory, accuracy
  --profile             Fazer profile antes da otimização
  --benchmark          Executar benchmarks
  --aggressive         Otimização agressiva
  --safe-mode         Apenas otimização segura

Exemplos:
*optimize-performance --target speed --profile
*optimize-performance --target memory --safe-mode
*optimize-performance --benchmark --aggressive

Comandos do Sistema

*backup

Cria backup do sistema.

*backup [options]

Options:
  --include <items>      Itens: config, agents, memory, all
  --exclude <items>     Excluir itens específicos
  --destination <path>  Destino do backup
  --compress           Comprimir backup
  --encrypt           Criptografar backup

Exemplos:
*backup --include all --compress
*backup --include "agents,config" --destination backups/
*backup --exclude memory --encrypt

*restore

Restaura de backup.

*restore <backup-file> [options]

Options:
  --items <list>        Itens específicos para restaurar
  --preview            Visualizar operação de restauração
  --force             Forçar restauração sem confirmação
  --merge             Mesclar com dados existentes

Exemplos:
*restore backups/backup-2024-01-01.zip
*restore backup.tar.gz --items "agents,config"
*restore latest-backup --preview

*update

Atualiza o Synkra AIOX.

*update [options]

Options:
  --check              Apenas verificar atualizações
  --version <version>  Atualizar para versão específica
  --beta              Incluir versões beta
  --force            Forçar atualização
  --backup          Criar backup antes de atualizar

Exemplos:
*update --check
*update --version 2.0.0 --backup
*update --beta --force

*uninstall

Desinstala componentes ou sistema inteiro.

*uninstall [component] [options]

Options:
  --keep-data         Manter dados do usuário
  --keep-config      Manter configuração
  --complete         Desinstalação completa
  --dry-run         Visualizar desinstalação

Exemplos:
*uninstall agent-name
*uninstall --complete --keep-data
*uninstall memory-layer --dry-run

*doctor

Diagnósticos e reparo do sistema.

*doctor [options]

Options:
  --fix              Auto-corrigir problemas detectados
  --deep            Varredura profunda do sistema
  --report <path>   Salvar relatório de diagnóstico
  --component <name> Verificar componente específico

Exemplos:
*doctor
*doctor --fix
*doctor --deep --report diagnosis.json
*doctor --component memory-layer

Comandos Avançados

*export

Exporta configurações, agentes ou dados.

*export <type> [options]

Tipos:
  config              Exportar configuração
  agents             Exportar agentes
  workflows          Exportar workflows
  memory            Exportar dados de memória
  all              Exportar tudo

Options:
  --format <type>     Formato: json, yaml, archive
  --destination <path> Destino da exportação
  --include-sensitive Incluir dados sensíveis
  --pretty          Formatação legível

Exemplos:
*export config --format yaml
*export agents --destination exports/agents/
*export all --format archive --destination backup.zip

*import

Importa configurações, agentes ou dados.

*import <file> [options]

Options:
  --type <type>       Tipo de importação: config, agents, workflows
  --merge            Mesclar com existente
  --replace         Substituir existente
  --validate       Validar antes de importar
  --dry-run       Visualizar importação

Exemplos:
*import agents.json --type agents --merge
*import config.yaml --replace --validate
*import backup.zip --dry-run

*benchmark

Executa benchmarks de desempenho.

*benchmark [suite] [options]

Suítes:
  all               Executar todos os benchmarks
  generation       Velocidade de geração de código
  analysis        Desempenho de análise
  memory          Operações de memória
  e2e            Workflows de ponta a ponta

Options:
  --iterations <num>   Número de iterações
  --compare <baseline> Comparar com baseline
  --save-results      Salvar resultados do benchmark
  --profile          Incluir dados de profiling

Exemplos:
*benchmark all --iterations 10
*benchmark generation --compare v1.0.0
*benchmark memory --profile --save-results

*debug

Operações do modo debug.

*debug <command> [options]

Comandos:
  enable              Habilitar modo debug
  disable            Desabilitar modo debug
  logs <level>       Mostrar logs de debug
  trace <operation>  Rastrear operação específica
  breakpoint <location> Definir breakpoint

Options:
  --verbose          Saída detalhada
  --filter <pattern> Filtrar saída de debug
  --save <path>     Salvar sessão de debug

Exemplos:
*debug enable --verbose
*debug logs error --filter "api"
*debug trace create-agent --save debug-session.log

*plugin

Gerenciamento de plugins.

*plugin <operation> [options]

Operações:
  install <name>      Instalar plugin
  remove <name>      Remover plugin
  list              Listar plugins instalados
  search <query>    Buscar plugins disponíveis
  create <name>     Criar novo plugin

Options:
  --version <ver>     Versão do plugin
  --source <url>     Fonte do plugin
  --enable          Habilitar após instalação
  --dev            Modo de desenvolvimento

Exemplos:
*plugin install code-formatter --enable
*plugin create my-custom-plugin --dev
*plugin search "testing"
*plugin list --detailed

Atalhos de Comandos

Comandos comuns têm atalhos:

*h     → *help
*s     → *status
*la    → *list-agents
*lt    → *list-tasks
*lw    → *list-workflows
*ca    → *create-agent
*ct    → *create-task
*cw    → *create-workflow
*a     → *analyze-framework
*i     → *improve-code-quality

Encadeamento de Comandos

Encadeie múltiplos comandos:

# Usando && para execução sequencial
*analyze-framework && *suggest-improvements && *generate-report

# Usando pipes para fluxo de dados
*analyze-code src/ | *improve-code-quality | *generate-tests

# Usando ; para execução independente
*backup ; *update ; *doctor --fix

Modo Interativo

Entre no modo interativo para comandos contínuos:

*interactive

AIOX> create-agent helper
AIOX> activate helper
AIOX> helper translate "Hello" --to spanish
AIOX> exit

Variáveis de Ambiente

Controle o comportamento com variáveis de ambiente:

AIOX_AI_PROVIDER=openai          # Provedor de IA
AIOX_AI_MODEL=gpt-4             # Modelo de IA
AIOX_LOG_LEVEL=debug            # Nível de log
AIOX_TELEMETRY=disabled         # Configuração de telemetria
AIOX_TIMEOUT=30000             # Timeout de comando (ms)
AIOX_MEMORY_CACHE=true         # Cache de memória

Tratamento de Erros

Respostas de erro comuns e soluções:

# Permissão negada
*sudo <command>                 # Executar com permissões elevadas

# Comando não encontrado
*help <command>                # Verificar nome correto do comando
*update                       # Atualizar para versão mais recente

# Erro de timeout
*config --set timeout 60000   # Aumentar timeout
*<command> --async           # Executar assincronamente

# Erro de memória
*memory clear-cache          # Limpar cache de memória
*optimize-performance --target memory

Dicas Profissionais:

  1. Use *help <command> liberalmente - fornece exemplos detalhados
  2. Auto-completar por tab funciona para comandos e parâmetros
  3. Histórico de comandos disponível com setas cima/baixo
  4. Use --dry-run para visualizar operações perigosas
  5. Combine comandos com pipes e encadeamentos para workflows poderosos

Lembre-se: O meta-agente aprende com seus padrões de uso. Quanto mais você usa, melhor ele se torna em antecipar suas necessidades!