change · diff
git:20260902.5fa5897 to git:20260903.6170a65
15 added, 9 removed. Audit A to A.
---
name: change
- description: Поправить готовый продукт в этой папке — одно маленькое изменение, а не стройка. Использовать, когда человек пишет /change или говорит «поправь», «добавь кнопку», «добавь поле», «добавь страницу», «измени цвет», «измени текст», «убери поле», «переименуй», «сделай чтобы…» — про то, что у него уже работает. Только про это: стройку большого берёт /go, разбор поломок — /fix. Снимок до и после, правку пишет агент builder, слово «готово» — после проверки кодом возврата.
+ description: Поправить готовый продукт в этой папке — одно маленькое изменение, а не стройка. Использовать, когда человек пишет /change или говорит «поправь», «добавь кнопку», «добавь поле», «добавь страницу», «измени цвет», «измени текст», «убери поле», «переименуй», «сделай чтобы…» — про то, что у него уже работает. По-английски: «change the button», «add a field», «make the text shorter». Только про это: стройку большого берёт /go, разбор поломок — /fix. Снимок до и после, правку пишет агент builder, слово «готово» — после проверки кодом возврата.
argument-hint: "<что поправить>"
---
# CHANGE — одна правка того, что уже работает
Правка кажется мелкой — и файлы правятся руками, мимо снимков и проверки.
Тогда «поправил цвет» и «уронил форму заказа» выглядят одинаково: одной
строкой в чате. Порядок ниже не сокращают.
## 1. Отметить папку — до любой записи
```bash
python3 "$CLAUDE_PLUGIN_ROOT/tools/enable.py" .
```
Код 4 — это домашняя папка человека, а не папка продукта: дальше не идёшь,
скажи одной фразой и спроси, где лежит то, что правим.
## 2. Снимок ДО правки
```bash
python3 "$CLAUDE_PLUGIN_ROOT/tools/checkpoint.py" . snap "до правки: <фраза человека>"
```
Раньше, чем что-либо изменилось, — иначе возвращать будет некуда. Название
этапа — словами человека: он узнает его в списке.
## 3. Уточнять — только если просьба двоится
Одна фраза, и только когда понять можно двумя способами («убери поле» — какое
из двух?). Понятную правку не переспрашивают: вопрос ради вежливости
перекладывает работу на человека. Спросил — свой вариант первым.
## 4. Правку пишет builder, не ты
Один вызов агента `builder`, одна правка; файлы продукта сам не трогай.
- В промпт вложи ровно это, иначе он додумает:
+ Промпт не сочиняй — его собирает код:
- > Что поправить: <просьба человека дословно>.
- > Где можно менять: <файл или папка>. Больше нигде.
- > Готово, когда: <признак, который видно глазами или прогоном>.
- > Команда тестов: <команда проекта>, прогнать до возврата.
- > Соседнее не переписывай и заодно ничего не чини.
+ ```bash
+ python3 "$CLAUDE_PLUGIN_ROOT/tools/handoff.py" --single "<просьба человека дословно>" \
+ --zone "<файл или папка>" \
+ --done "<признак, который видно глазами или прогоном>" \
+ --tests "<команда тестов проекта>"
+ ```
- Ход `/go` уже открыт и у правки есть свой таск — промпт собирает
- `$CLAUDE_PLUGIN_ROOT/tools/handoff.py`, тогда бери его.
+ Код 0 — отдай собранный текст агенту `builder` целиком, ничего не убирая.
+ Код 1 — названо, чего не хватает: допроси недостающее у себя или одной фразой
+ у человека и позови снова. Своей заготовкой это не заменяют: из неё первыми
+ выпадают запреты и команда тестов.
+
+ Ход `/go` уже открыт и у правки есть свой таск — тогда промпт собирает тот же
+ инструмент по состоянию хода, без `--single`.
## 5. Проверка
```bash
python3 "$CLAUDE_PLUGIN_ROOT/tools/verify.py" .
```
Код 0 — и только он — даёт право сказать «готово». Код 1 — правка не вышла,
код 2 — проверять нечем; так и скажи, не выдавая за сделанное.
## 6. Если это страница — посмотреть
```bash
python3 "$CLAUDE_PLUGIN_ROOT/tools/page_check.py" .
```
Код 1 — на странице пусто, показывать как результат нельзя. Иначе дай адрес,
по которому он сам увидит правку.
## 7. Снимок ПОСЛЕ правки
```bash
python3 "$CLAUDE_PLUGIN_ROOT/tools/checkpoint.py" . snap "после правки: <что изменилось>"
```
Два снимка вокруг правки и делают «верни как было» одной фразой.
## 8. Две строки человеку
Что изменилось — его словами. Как открыть. Больше ничего: ни списка файлов,
ни вывода команд.
> Кнопка отмены записи появилась на странице заказа. Открой её и попробуй.
Скажет «верни как было» — это /oops: он покажет снимки и вернёт выбранный.