docs(agents): правка тела issue идёт через API, а не через tea #55

Merged
ddmitry merged 1 commits from docs/issue-tracker-api-recipes into main 2026-08-06 09:28:06 +03:00
Owner

Рецепт правки тела issue, которого в доке не было.

Тикнуть чекбокс в критериях приёмки нужно при закрытии каждой задачи, и tea
для этого не годится: tea issues edit --description принимает тело целиком
строкой, а взять эту строку неоткуда — вывод tea issues <номер> обёрнут и
разрисован для терминала. Наступили при закрытии #37.

Добавлен раздел с рабочим рецептом (сырой JSON из API → правка body
-X PATCH -d @файл), разбор флагов tea api и заметка, что флага --input
нет, хотя рука тянется. Тот же приём — для чек-листа родительской карты.

Оттуда же общее правило: CLI удобен, пока команда создаёт объект или меняет
его свойство — создать issue, добавить комментарий, повесить метку, закрыть.
Как только надо изменить уже написанный текст, он мешает: умеет заменить всё
целиком, а прочитать это «всё» в пригодном для правки виде не даёт.

Проверка: рецепт снят живыми запросами при закрытии #37 — так проставлены
чекбоксы тикета и пункт в чек-листе карты #4. make config-test зелёный.

🤖 Generated with Claude Code

Рецепт правки тела issue, которого в доке не было. Тикнуть чекбокс в критериях приёмки нужно при закрытии каждой задачи, и `tea` для этого не годится: `tea issues edit --description` принимает тело целиком строкой, а взять эту строку неоткуда — вывод `tea issues <номер>` обёрнут и разрисован для терминала. Наступили при закрытии #37. Добавлен раздел с рабочим рецептом (сырой JSON из API → правка `body` → `-X PATCH -d @файл`), разбор флагов `tea api` и заметка, что флага `--input` нет, хотя рука тянется. Тот же приём — для чек-листа родительской карты. Оттуда же общее правило: CLI удобен, пока команда создаёт объект или меняет его свойство — создать issue, добавить комментарий, повесить метку, закрыть. Как только надо изменить уже написанный текст, он мешает: умеет заменить всё целиком, а прочитать это «всё» в пригодном для правки виде не даёт. Проверка: рецепт снят живыми запросами при закрытии #37 — так проставлены чекбоксы тикета и пункт в чек-листе карты #4. `make config-test` зелёный. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
ddmitry added 1 commit 2026-08-06 09:25:30 +03:00
Зачем: тикнуть чекбокс в критериях приёмки нужно при закрытии каждой задачи,
а рецепта в доке не было. Наступили на это при закрытии #37: `tea issues edit
--description` требует тело целиком строкой, но взять её неоткуда — вывод
`tea issues <номер>` обёрнут и разрисован для терминала.

Что: раздел «Правка тела issue — только через API» с рабочим рецептом
(забрать сырой JSON, поправить body, вернуть через `-X PATCH -d @файл`) и
разбором флагов `tea api`. Оттуда же общее правило: CLI удобен, пока команда
создаёт объект или меняет его свойство, и мешает, как только надо изменить
уже написанный текст. Ссылка из раздела про автозакрытие и запись в «Что
проверено и когда».

Проверка: рецепт снят живыми запросами при закрытии #37 — так проставлены
чекбоксы тикета и пункт в чек-листе карты #4. `make config-test` зелёный.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
ddmitry merged commit 18200fb97f into main 2026-08-06 09:28:06 +03:00
ddmitry deleted branch docs/issue-tracker-api-recipes 2026-08-06 09:28:09 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#55