Функции в этом руководствеFunctions in this guideФункції в цьому посібнику
- Внести мелкую правку без церемонийMake a one-line edit without ceremonyВнести дрібну правку без церемонійОпечатка, константа или подпись исправлены за одно предложение: без спеки и без сборки.A typo, a constant or a label changed in one sentence's worth of work: no spec, no build gate.Одруківку, константу чи підпис виправлено за одне речення: без спеки й без збірки.
- Исправить узкий баг без церемонийFix a narrow bug without ceremonyВиправити вузький баг без церемонійБаг с понятной причиной исправлен в корне: минимальная правка, одна локальная проверка, отчёт в три строки, без спеки.A bug with a known cause is fixed at the root: smallest change, one local check, a three-line report, no spec.Баг зі зрозумілою причиною виправлено в корені: мінімальна правка, одна локальна перевірка, звіт у три рядки, без спеки.
- Отложить находку вне задачи и продолжить работуPark an out-of-scope finding and keep workingВідкласти знахідку поза задачею й продовжити роботуНастоящая проблема, замеченная по ходу дела, становится минимальной заготовкой со статусом Draft за одну строку, и вы сразу возвращаетесь к своему делу.A real problem found mid-task becomes a minimal Draft stub in one line, and you go straight back to what you were doing.Справжню проблему, помічену по ходу діла, перетворено на мінімальну заготовку зі статусом Draft за один рядок, і ви одразу повертаєтеся до своєї справи.
- Запустить изменение и проверить, что оно правда работаетRun a change and see whether it actually worksЗапустити зміну й перевірити, що вона справді працюєЗапустить и посмотреть: проверка заканчивается одной строкой, PASS, DEFECT, COULD NOT VERIFY или NOT APPLICABLE, с путём к свидетельствам.Run the thing and observe it: the check ends in one line, PASS, DEFECT, COULD NOT VERIFY or NOT APPLICABLE, with the path to its evidence.Запустити й подивитися: перевірка закінчується одним рядком, PASS, DEFECT, COULD NOT VERIFY або NOT APPLICABLE, зі шляхом до свідчень.
- Провести ревью изменения и получить замечания по серьёзностиCritique a change and get findings by severityПровести рев'ю зміни й отримати зауваження за серйозністюСжатое ревью diff, документа, набора данных или договора: сначала замечания, самые серьёзные выше, у каждого место и конкретная правка.A terse review of a diff, a document, a dataset or a contract: findings first, highest severity on top, each with a place and a concrete fix.Стисле рев'ю diff, документа, набору даних чи договору: спершу зауваження, найсерйозніші вгорі, у кожного місце й конкретна правка.
- Обновить все места, где пользователь встречает изменение, под одним именемUpdate every place a user meets a change, under one nameОновити всі місця, де користувач зустрічає зміну, під одним іменем
/surfacesперечисляет все места, где пользователь встречает изменение, до правок, затем выравнивает каждое затронутое под одним именем в каждой авторской локали./surfaceslists every place a user meets a change before any edit, then makes each touched one say the same thing, under one name, in every authored locale./surfacesперелічує всі місця, де користувач зустрічає зміну, до правок, потім вирівнює кожне зачеплене під одним іменем у кожній авторській локалі. - Разложить изменения по чистым коммитамSort your changes into clean commitsРозкласти зміни по чистих комітах
/gitразбивает изменения на 2-4 логичных коммита, с сообщениями и точными командамиgit add, и не коммитит и не пушит, пока вы не попросите./gitgroups your changes into 2 to 4 logical commits, with messages and exactgit addcommands, and does not commit or push unless you ask./gitрозбиває зміни на 2-4 логічні коміти, з повідомленнями й точними командамиgit add, і не комітить та не пушить, доки ви не попросите.
ШагиStepsКроки
- Выберите путь по тому, чего касается правка. Для одного токена, строки, подписи, цвета или локального переименования подходит
/quick:/quick fix typo in the Save button label. Он вносит правку, запускает самую маленькую подходящую проверку и отчитывается одним предложением. Он отказывается от бизнес-логики, поведения для пользователя, нового класса, функции или модуля, схемы, зависимостей и конфигурации сборки, а также от всего, что больше 3 файлов или примерно 50 строк.Choose the path by what the change touches. For one token, string, label, colour or a local rename, use/quick:/quick fix typo in the Save button label. It makes the edit, runs the smallest check that fits and reports in one sentence. It refuses business logic, user-facing behaviour, a new class, function or module, a schema, dependency or build config, and anything over 3 files or about 50 lines.Оберіть шлях за тим, чого торкається правка. Для одного токена, рядка, підпису, кольору чи локального перейменування годиться/quick:/quick fix typo in the Save button label. Він вносить правку, запускає найменшу відповідну перевірку й звітує одним реченням. Він відмовляється від бізнес-логіки, поведінки для користувача, нового класу, функції чи модуля, схеми, залежностей і конфігурації збірки, а також від усього, що більше за 3 файли чи приблизно 50 рядків. - Для бага с понятной причиной, который больше однострочной правки, берите
/fix:/fix retry loop never backs off, hammers the server on 503. Он называет первопричину до того, как тронет код, вносит самую маленькую правку, которая её устраняет, проверяет результат локально и отчитывается тремя строками: причина, правка, проверка. Если причина всё ещё неясна, сначала нужен/research.For a bug with an understood cause that is bigger than a one-line edit, use/fix:/fix retry loop never backs off, hammers the server on 503. It names the root cause before it touches code, makes the smallest change that removes it, checks the result locally and reports cause, fix and validation in three lines. If the cause is still unclear,/researchcomes first.Для багу зі зрозумілою причиною, що більший за однорядкову правку, беріть/fix:/fix retry loop never backs off, hammers the server on 503. Він називає першопричину, перш ніж торкнеться коду, вносить найменшу правку, що її усуває, перевіряє результат локально й звітує трьома рядками: причина, правка, перевірка. Якщо причина досі неясна, спершу потрібен/research. - Знайте, где кончается дешёвый путь. Решение о дизайне или UX идёт в
/ui-clarify, затем в/spec; новая абстракция, схема или миграция, публичный API - в/spec. Когда команда упирается в эту границу, она так и говорит:/quickодной строкой называет причину и подходящую команду и ничего не меняет, а/fixостанавливается посреди работы и передаёт задачу дальше, если список файлов вырос больше чем до нескольких. Принимайте перенаправление, а не проталкивайте правку силой.Know where the cheap path ends. A design or UX decision goes to/ui-clarifyand then/spec; a new abstraction, a schema or migration, or a public API goes to/spec. When a command meets that edge it says so:/quickanswers in one line with the reason and the command that fits and changes nothing, and/fixstops midway and escalates if its file list outgrows a handful of files. Take the redirect instead of pushing the edit through.Знайте, де закінчується дешевий шлях. Рішення про дизайн чи UX іде до/ui-clarify, потім до/spec; нова абстракція, схема або міграція, публічний API - до/spec. Коли команда впирається в цю межу, вона так і каже:/quickодним рядком називає причину й відповідну команду та нічого не змінює, а/fixзупиняється посеред роботи й передає задачу далі, якщо список файлів виріс більше ніж до кількох. Приймайте перенаправлення, а не проштовхуйте правку силоміць. - Когда по дороге нашлась настоящая проблема вне задачи, которой нужно отдельное расследование, отложите её:
/park retry loop in sync_client never backs off - found while auditing the cache layer. Команда записывает минимальную заготовку тикета со статусомDraft, приоритетом по умолчанию, симптомом в одну строку и местом находки, ничего не расследует и возвращает вас к задаче. Тривиальную строку вне задачи правьте на месте, косметическую придирку отбросьте, находку в рамках задачи считайте работой. Заготовка - живой тикет:/backlogподберёт его, а/spec <ID>развернёт.When you find a real problem outside the task that needs its own investigation, park it:/park retry loop in sync_client never backs off - found while auditing the cache layer. It writes a minimalDraftticket stub with a default priority, a one-line symptom and where you found it, investigates nothing and returns you to the task. Fix a trivial out-of-scope line inline, drop a cosmetic nitpick, and treat an in-scope finding as work. The stub is a live ticket:/backlogcan pick it up and/spec <ID>can expand it.Коли дорогою знайшлася справжня проблема поза задачею, якій потрібне окреме розслідування, відкладіть її:/park retry loop in sync_client never backs off - found while auditing the cache layer. Команда записує мінімальну заготовку тікета зі статусомDraft, пріоритетом за замовчуванням, симптомом в один рядок і місцем знахідки, нічого не розслідує й повертає вас до задачі. Тривіальний рядок поза задачею правте на місці, косметичну прискіпливість відкиньте, знахідку в межах задачі вважайте роботою. Заготовка - живий тікет:/backlogпотім підбере його, а/spec <ID>розгорне. - Когда важно поведение, проверьте правку запуском.
/proveзапускает цель, проходит короткий сценарий, снимает вывод и заканчивает одной строкой ровно с одним вердиктом: PASS, DEFECT, COULD NOT VERIFY или NOT APPLICABLE. Прохождением считается только PASS./proveбез аргументов - дымовой прогон по умолчанию, с вашим текстом он берёт этот текст как сценарий, а--buildсначала пересобирает. Файл сценария ложится в каталог scratch.Check the change by running it when behaviour matters./provestarts the target, walks a short scenario, captures the output and ends in one line with exactly one verdict: PASS, DEFECT, COULD NOT VERIFY or NOT APPLICABLE. Only PASS is a pass./provealone is a default smoke run,/proveplus your own text takes that text as the scenario, and--buildrebuilds first. The scenario file lands in the scratch directory.Коли важлива поведінка, перевірте правку запуском./proveзапускає ціль, проходить короткий сценарій, знімає вивід і закінчує одним рядком рівно з одним вердиктом: PASS, DEFECT, COULD NOT VERIFY або NOT APPLICABLE. Проходженням вважається лише PASS./proveбез аргументів - димовий прогін за замовчуванням, з вашим текстом він бере цей текст як сценарій, а--buildспершу перезбирає. Файл сценарію лягає в каталог scratch. - Отдайте дифф на ревью командой
/critique: без аргументов она берёт текущий дифф, а область можно сузить, например/critique src/payments/. Она читает изменение и достаточно окружающего кода и выдаёт каждое замечание в видеseverity·file:line· проблема · конкретная правка, отbugдоq, а в конце называет единственное самое важное, что нужно решить до слияния. Замечания высокой серьёзности она сначала подтверждает или опровергает сама. Для одной короткой строки на замечание есть/caveman-review.Have the diff reviewed with/critique: bare, it takes the current diff, or scope it, for example/critique src/payments/. It reads the change and enough surrounding code and reports each finding asseverity·file:line· the problem · a concrete fix, frombugdown toq, then the single most important thing to address before merge. It confirms or refutes its own high-severity findings first. For one terse line per finding, use/caveman-review.Віддайте діф на рев'ю командою/critique: без аргументів вона бере поточний діф, а область можна звузити, наприклад/critique src/payments/. Вона читає зміну й достатньо навколишнього коду та видає кожне зауваження у виглядіseverity·file:line· проблема · конкретна правка, відbugдоq, а наприкінці називає єдине найважливіше, що треба розв'язати до злиття. Зауваження високої серйозності вона спершу підтверджує або спростовує сама. Для одного короткого рядка на зауваження є/caveman-review. - Если изменение видит пользователь, закончите
/surfaces: без аргументов для текущего диффа или с однострочным описанием. Команда печатает таблицу всех мест, где изменение видно (поверхностей): строки интерфейса по авторским локалям, справка, README и его переводы, документация, сайт, журнал изменений, карточки. Каждая строка либо затронута, либо не применима с причиной; затронутые правятся во всех авторских локалях, а по ним ищутся ключевое существительное и прежнее имя. Внутреннее изменение сразу заканчивается строкойsurfaces: not user-visible - <reason>.If a user can see the change, finish with/surfaces: bare for the current diff, or with a one-line description. It prints a table of every place the change shows, each one a surface: UI strings per authored locale, help, the README and its translations, docs, the site, the change log, listings. Each row is touched or not applicable with a reason, touched rows are edited in every authored locale, and the key noun and any old name are grepped across them. An internal change ends at once withsurfaces: not user-visible - <reason>.Якщо зміну бачить користувач, завершіть/surfaces: без аргументів для поточного діфа або з однорядковим описом. Команда друкує таблицю всіх місць, де зміну видно, кожне з них - поверхня: рядки інтерфейсу за авторськими локалями, довідка, README та його переклади, документація, сайт, журнал змін, картки. Кожен рядок або зачеплений, або незастосовний із причиною; зачеплені правляться в усіх авторських локалях, а по них шукаються ключовий іменник і попереднє ім'я. Внутрішня зміна одразу завершується рядкомsurfaces: not user-visible - <reason>. - Разложите готовые изменения по коммитам с помощью
/git:/git what should I commit now?. Он читаетgit statusи активную ветку, группирует файлы по темам в 2-4 логичных коммита, называет файлы, которые коммитить нельзя (результат сборки, кэши, секреты, всё из scratch), и предлагает сообщения в формате Conventional Commit с точными командамиgit add. Пока вы не попросите, он не коммитит и не пушит.Sort the finished changes into commits with/git:/git what should I commit now?. It readsgit statusand the active branch, groups files by concern into 2 to 4 logical commits, names the files that must stay out, such as build output, caches, secrets and anything under scratch, and proposes Conventional Commit messages with the exactgit addcommands. It does not commit or push unless you ask.Розкладіть готові зміни по комітах за допомогою/git:/git what should I commit now?. Він читаєgit statusта активну гілку, групує файли за темами у 2-4 логічні коміти, називає файли, які комітити не можна (результат збирання, кеші, секрети, усе зі scratch), і пропонує повідомлення у форматі Conventional Commit з точними командамиgit add. Доки ви не попросите, він не комітить і не пушить.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
Отчёт в одно предложение от /quick или в три строки от /fix, побочные находки записаны заготовками Draft, а не превратились в объезды, строка с вердиктом от /prove там, где важно поведение, отчёт /critique по серьёзности, отчёт /surfaces для видимого пользователю изменения и 2-4 группы коммитов с сообщениями и командами git add.A one-sentence report from /quick or a three-line report from /fix, side findings recorded as Draft stubs instead of detours, a verdict line from /prove where behaviour mattered, a /critique report by severity, a /surfaces report for a user-visible change, and 2 to 4 commit groups with messages and git add commands.Звіт в одне речення від /quick або в три рядки від /fix, побічні знахідки записані заготовками Draft, а не перетворилися на об'їзди, рядок із вердиктом від /prove там, де важлива поведінка, звіт /critique за серйозністю, звіт /surfaces для видимої користувачеві зміни і 2-4 групи комітів із повідомленнями та командами git add.