Перш ніж надати команді коротке ім'я, потрібно знати, що вона робить насправді. 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 і повідомляє справжній код виходу в картці, де нульовий код означає, що файл завантажився без помилок. Живі оновлення в командному рядку також залежать від цього кроку, оскільки поточна оболонка бачить змінений файл лише після його повторного завантаження. Запустіть аліас. Агент вводить нове ім'я, показує вивід, і ви порівнюєте його з командою, яку очікували. Якщо код виходу не нульовий, ви читаєте помилку в розгорнутій картці та запитуєте виправлення, а потім відкриваєте другий термінал і також пробуєте аліас там.
