Voordat je een commando een korte naam geeft, moet je weten wat het echt doet. SeedSpindle voert de lookup uit in je Linux-shell via WSL of SSH, toont de handleidingstekst in een chatkaart en stelt vervolgens het alias voor als een diff. Je beidt beide. De lookup komt eerst, dus het alias is gebaseerd op wat de handleiding zegt en niet op geheugen. Elke stap hieronder is een kaart in de chat, en de werkmap bevat het aliassenbestand, de back-up en eventuele notities die je de agent vraagt te schrijven. Er wordt niets uitgevoerd buiten de omgeving die je hebt gekozen. Wanneer je klaar bent, geven het aliassenbestand, de back-up en de kaarten van de sessie je een compleet overzicht van wat er is gewijzigd, wat je opnieuw kunt lezen wanneer de shell zich vreemd gedraagt. Beginners slaan de lookup vaak over en plakken een regel uit een forum, dus deze workflow zet de lookup om in de eerste kaart van elke taak.
Kies de werkmap en de WSL- of SSH-omgeving voor je shell, zodat de bestands- en Shell-gereedschappen naar dezelfde machine verwijzen. Kies de map die je dotfiles of een kopie daarvan bevat. De bestands-gereedschappen werken alleen in die map, terwijl Shell draait in de omgeving die je hebt gekozen. Open het een keer en de keuze blijft behouden voor de volgende taak.
Noem het commando dat je wilt begrijpen voordat je het een korte naam geeft, en vraag de agent om het bijpassende help- of manual-commando uit te voeren. Citeer de exacte naam. Vraag voor een ingebouwd commando om de helptekst, en voor een gewoon programma om de man-pagina. Geef aan tot welke shell het commando behoort als je er meer dan één gebruikt.
Lees de voorgestelde aliasregel en accepteer deze alleen als deze past bij je gewoontes en niet verbergt wat het commando echt doet. Wijs alles af dat lijkt op een afkorting voor iets destructiefs. De diff markeert toegevoegde regels in groen en verwijderde regels in rood, dus in één oogopslag zie je de omvang van de wijziging.
Shell laadt het bestand en toont de echte exitcode in een kaart, en het volgende alias-commando toont of de nieuwe naam bekend is. Als de naam onbekend is, toont de kaart de fout en vraag je om een correctie. Voer elke nieuwe naam één keer uit in een nieuwe terminal.
man dfexit 0~/.bash_aliasesgeladen~/.bash_aliases+1 regelsource ~/.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'Elk alias hier leest alleen: ls lijst bestanden, df en du rapporteren schijfruimte, en history geeft recente commando's weer. Opmerkingregels beginnen met # en verklaren elke groep, zodat je je later herinnert waarom de regels bestaan. Houd één lege regel tussen groepen, en houd elke regel kort genoeg om in een diff te lezen zonder horizontaal te hoeven scrollen. Voeg je eigen groep toe onder de laatste, en laat de agent de diff zien voordat je het opslaat. Korte namen zijn makkelijker in te typen, maar houd ze verschillend van echte commando's zodat niets per ongeluk wordt overschaduwd. Beoordeel elke nieuwe regel voordat je het opslaat.
Taak: leer wat een bash-ingebouwd commando doet voordat je het alias maakt. Een linux help-commando zoals help cd drukt de documentatie van een ingebouwd commando af, en de agent voert het uit via Shell zodat de tekst verschijnt in een uitbreidbare chatkaart. Je leest de opties, beslist welke er in het alias horen, en vraagt vervolgens om de regel. Wees precies. edit_file stelt het alias voor als een diff, en het alias mag nooit verbergen wat het commando echt doet. Een verkeerde gok kost weinig, omdat de back-up slechts één copy_file-oproep verwijderd is. Ask first pauzeert voordat het schrijven, dus je accepteert de diff, voert source uit op het bestand, en bevestigt de exitcode in de volgende kaart.
Taak: vind een commando als je alleen weet wat het doet. Het uitvoeren van apropos met een zoekwoord doorzoekt de korte beschrijvingen van handleidingen, en de agent toont de lijst in een kaart. Het typen van apropos linux zou een zeer lange lijst opleveren, terwijl een nauwer zoekwoord zoals disk minder, betere treffers oplevert. Een shellgeschiedenis die het project van elk commando kent vereist extra configuratie buiten aliassen, en de agent kan die bashrc-regels als een diff opstellen als je het vraagt. Kies er één. Lees de handleiding met man, vraag vervolgens om het alias, en beoordeel de diff voordat je het accepteert.
Taak: wijzig een dotfile zonder je volgende inlogsessie te breken. Het debuggen van een padprobleem met dotfiles begint met het lezen van het bestand dat PATH instelt, en de agent doet dat met read_file en grep, die elke matchende regel toont. Het gebruikt vervolgens copy_file om het origineel op te slaan en edit_file om de correctie voor te stellen als een diff. Houd de kopie. Veel padproblemen komen door een typefout, dus de diff heeft vaak slechts één gewijzigde regel nodig, en een herstel is een enkele copy_file-oproep als de nieuwe configuratie faalt. Plan only laat je het hele plan lezen voordat een bestand verandert, en de eindcontrole is een nieuwe shell waarin je bevestigt dat het commando wordt gevonden.
Taak: bevestig dat het alias laadt. Nadat je de diff accepteert, voert de agent source uit op het bestand via Shell en rapporteert de echte exitcode in de kaart, waar een nulcode betekent dat het bestand zonder fout is geladen. Live-updates in een shell-prompt hangen ook af van deze stap, omdat de huidige shell een gewijzigd bestand pas ziet nadat het opnieuw is geladen. Voer het alias uit. De agent typt de nieuwe naam, toont de uitvoer, en je vergelijkt het met het commando dat je verwachtte. Als de exitcode niet nul is, lees je de fout in de uitgebreide kaart en vraag je om een correctie, en open je een tweede terminal om het alias daar ook te proberen.
