Antes de criar um atalho para um comando, você precisa saber o que ele realmente faz. O SeedSpindle executa a pesquisa no seu shell Linux via WSL ou SSH, exibe o texto do manual em um cartão de chat e, em seguida, propõe o alias como um diff. Você revisa ambos. A pesquisa vem primeiro, para que o alias seja baseado no que o manual diz e não na memória. Cada etapa abaixo é um cartão no chat, e a pasta de trabalho contém o arquivo de aliases, seu backup e quaisquer notas que você pedir ao agente para escrever. Nada é executado fora do ambiente que você escolheu. Quando terminar, o arquivo de aliases, o backup e os cartões da sessão fornecem um registro completo do que mudou, que você pode ler novamente sempre que o shell se comportar de forma estranha. Iniciantes muitas vezes pulam a pesquisa e colam uma linha de um fórum, então este fluxo de trabalho torna a pesquisa a primeira etapa de cada tarefa.
Escolha a pasta de trabalho e o ambiente WSL ou SSH para o seu shell, para que as ferramentas de arquivo e o Shell apontem para a mesma máquina. Escolha a pasta que contém seus dotfiles ou uma cópia deles. As ferramentas de arquivo funcionam apenas nessa pasta, enquanto o Shell é executado no ambiente que você escolheu. Abra uma vez e a escolha é mantida para a próxima tarefa.
Informe o nome do comando que você deseja entender antes de criar um atalho para ele e peça ao agente para executar o comando de ajuda ou manual correspondente. Cite o nome exato. Para um built-in, peça o texto de ajuda e, para um programa comum, peça sua página de manual. Informe a qual shell o comando pertence se você usar mais de um.
Leia a linha de alias proposta e aceite-a apenas se ela se adequar aos seus hábitos e não ocultar o que o comando realmente faz. Rejeite qualquer coisa que pareça um atalho para algo destrutivo. O diff marca as linhas adicionadas em verde e as removidas em vermelho, então uma única olhada mostra a magnitude da mudança.
O Shell carrega o arquivo e mostra o código de saída real em um cartão, e o próximo comando alias mostra se o novo nome é conhecido. Se o nome for desconhecido, o cartão mostra o erro e você pede uma correção. Execute cada novo nome uma vez em um terminal novo.
man dfexit 0~/.bash_aliasesloaded~/.bash_aliases+1 linesource ~/.bash_aliasesexit 0alias dfhexit 0# Read-only shortcuts for looking around
alias ll='ls -la'
alias la='ls -A'
alias l='ls -CF'
# Disk usage in readable units
alias dfh='df -h'
alias duh='du -sh'
# Show the last commands you typed
alias hist='history 20'Cada alias aqui é apenas para leitura: ls lista arquivos, df e du relatam o espaço em disco e history imprime os comandos recentes. Linhas de comentário começam com # e explicam cada grupo, para que você se lembre depois por que as linhas existem. Mantenha uma linha em branco entre os grupos e mantenha cada linha curta o suficiente para ser lida no diff sem rolagem horizontal. Adicione seu próprio grupo abaixo do último e deixe o agente mostrar o diff antes de salvá-lo. Atalhos são mais fáceis de digitar, mas mantenha-os diferentes dos comandos reais para que nada seja obscurecido por acidente. Revise cada nova linha antes de salvá-la.
Tarefa: aprenda o que um built-in do bash faz antes de criar um alias. Um comando linux help, como help cd, imprime a documentação de um built-in, e o agente o executa via Shell para que o texto apareça em um cartão de chat que você pode expandir. Leia as opções, decida quais pertencem ao alias e, em seguida, peça a linha. Seja preciso. edit_file propõe o alias como um diff, e o alias nunca deve ocultar o que o comando realmente faz. Um palpite errado custa pouco, porque o backup está a uma chamada de copy_file de distância. Ask first pausa antes da gravação, para que você aceite o diff, execute source no arquivo e confirme o código de saída no próximo cartão.
Tarefa: encontre um comando quando você só se lembra do que ele faz. Executar apropos com uma palavra-chave pesquisa as descrições curtas das páginas de manual, e o agente mostra a lista em um cartão. Digitar apropos linux retornaria uma lista muito longa, enquanto uma palavra mais específica, como disk, encontra menos correspondências melhores. Um histórico de shell que conhece o projeto de cada comando precisa de configuração extra além dos aliases, e o agente pode rascunhar essas linhas do bashrc como um diff se você pedir. Escolha um. Leia a página de manual com man, depois peça o alias e revise o diff antes de aceitá-lo.
Tarefa: altere um dotfile sem quebrar seu próximo login. A depuração de um problema de caminho com dotfiles começa lendo o arquivo que define PATH, e o agente faz isso com read_file e grep, que mostra todas as linhas correspondentes. Em seguida, usa copy_file para salvar o original e edit_file para propor a correção como um diff. Mantenha a cópia. Muitos problemas de caminho vêm de um erro de digitação, então o diff muitas vezes precisa apenas de uma linha alterada, e uma restauração é uma única chamada de copy_file se a nova configuração falhar. Plan only permite que você leia todo o plano antes de um arquivo ser alterado, e a verificação final é um shell novo onde você confirma que o comando é encontrado.
Tarefa: confirme que o alias é carregado. Após aceitar o diff, o agente executa source no arquivo via Shell e relata o código de saída real no cartão, onde um código zero significa que o arquivo foi carregado sem erro. Atualizações em tempo real em um prompt de shell também dependem desta etapa, porque o shell atual só vê um arquivo alterado depois que ele é carregado novamente. Execute o alias. O agente digita o novo nome, mostra a saída e você compara com o comando que esperava. Se o código de saída não for zero, leia o erro no cartão expandido e peça uma correção, depois abra um segundo terminal e tente o alias lá também.
