Прежде чем дать команде короткое имя, нужно понять, что она делает на самом деле. SeedSpindle выполняет поиск в вашей оболочке Linux через WSL или SSH, показывает текст руководства в карточке чата, а затем предлагает алиас в виде diff. Вы проверяете оба. Поиск выполняется первым, поэтому алиас основывается на данных руководства, а не на памяти. Каждый шаг ниже представлен карточкой в чате, а рабочая папка содержит файл алиасов, его резервную копию и любые заметки, которые вы попросите агента записать. Ничего не запускается за пределами выбранной среды. Когда вы закончите, файл алиасов, резервная копия и карточки сессии дадут вам полную запись о том, что изменилось, что вы можете прочитать снова, если оболочка поведёт себя странно. Новички часто пропускают поиск и вставляют строку из форума, поэтому этот рабочий процесс превращает поиск в первую карточку каждой задачи.
Выберите рабочую папку и среду WSL или SSH для вашей оболочки, чтобы инструменты работы с файлами и Shell указывали на одну и ту же машину. Выберите папку, содержащую ваши dotfiles или их копию. Инструменты работы с файлами работают только в этой папке, а Shell запускается в выбранной вами среде. Откройте её один раз, и выбор сохранится для следующей задачи.
Назовите команду, которую хотите понять, прежде чем давать ей короткое имя, и попросите агента выполнить соответствующую команду help или man. Укажите точное имя. Для встроенной команды запросите текст помощи, а для обычной программы — страницу руководства. Укажите, к какой оболочке относится команда, если вы используете более одной.
Прочитайте предлагаемую строку алиаса и примите её только если она соответствует вашим привычкам и не скрывает, что на самом деле делает команда. Отклоните всё, что выглядит как сокращение для чего-то разрушительного. Diff выделяет добавленные строки зелёным, а удалённые — красным, так что одним взглядом можно оценить масштаб изменений.
Shell загружает файл и показывает реальный код выхода в карточке, а следующая команда alias показывает, известно ли новое имя. Если имя неизвестно, карточка показывает ошибку, и вы просите исправить её. Запустите каждое новое имя один раз в новом терминале.
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'Каждый алиас здесь только для чтения: ls выводит список файлов, df и du сообщают о дисковом пространстве, а history печатает недавние команды. Строки комментариев начинаются с # и объясняют каждую группу, чтобы вы позже вспомнили, зачем существуют эти строки. Оставляйте одну пустую строку между группами и делайте каждую строку достаточно короткой, чтобы её можно было прочитать в diff без горизонтальной прокрутки. Добавьте свою группу ниже последней, и пусть агент покажет diff перед тем, как вы её сохраните. Короткие имена легче набирать, но делайте их отличными от реальных команд, чтобы ничего не затенилось случайно. Проверяйте каждую новую строку перед сохранением.
Задача: узнать, что делает встроенная команда bash, прежде чем создавать для неё алиас. Команда linux help, такая как help cd, выводит документацию встроенной команды, а агент выполняет её через Shell, так что текст появляется в карточке чата, которую можно развернуть. Вы читаете опции, решаете, какие из них подходят для алиаса, а затем просите создать строку. Будьте точны. edit_file предлагает алиас в виде diff, и алиас никогда не должен скрывать, что на самом деле делает команда. Ошибка обходится дешево, потому что резервная копия — это один вызов copy_file. Ask first приостанавливает процесс перед записью, так что вы принимаете diff, запускаете source для файла и подтверждаете код выхода в следующей карточке.
Задача: найти команду, когда вы помните только то, что она делает. Запуск apropos с ключевым словом ищет краткие описания страниц руководства, а агент показывает список в карточке. Ввод apropos linux вернет очень длинный список, тогда как более узкое слово, такое как disk, найдет меньше, но более подходящих совпадений. История оболочек, знающая проект каждой команды, требует дополнительной настройки помимо алиасов, и агент может набросать эти строки bashrc в виде diff, если вы попросите. Выберите один. Прочитайте страницу руководства с помощью man, затем запросите алиас и проверьте diff перед тем, как принять его.
Задача: изменить dotfile, не сломав следующий вход в систему. Отладка проблемы с путем в dotfiles начинается с чтения файла, который устанавливает PATH, и агент делает это с помощью read_file и grep, которые показывают каждую совпадающую строку. Затем он использует copy_file для сохранения оригинала и edit_file для предложения исправления в виде diff. Сохраните копию. Многие проблемы с путями возникают из-за опечатки, поэтому diff часто требует изменения только одной строки, а восстановление — это один вызов copy_file, если новая конфигурация не сработает. Plan only позволяет вам прочитать весь план перед изменением файла, а финальная проверка — это новая оболочка, где вы подтверждаете, что команда найдена.
Задача: подтвердить, что алиас загружается. После принятия diff агент запускает source для файла через Shell и сообщает реальный код выхода в карточке, где нулевой код означает, что файл загрузился без ошибок. Живые обновления в приглашении оболочки также зависят от этого шага, потому что текущая оболочка видит измененный файл только после его повторной загрузки. Запустите алиас. Агент вводит новое имя, показывает вывод, и вы сравниваете его с ожидаемой командой. Если код выхода не равен нулю, вы читаете ошибку в развернутой карточке и просите исправить её, затем открываете второй терминал и пробуете алиас там тоже.
