docs(agents): у правки комментария свой путь в API

Зачем: резолюции wayfinder-тикетов живут комментариями, и правка после
ревью идёт в них — а дока описывала только правку тела issue. Путь
неочевидный: без номера issue, по идентификатору из ленты.

Что: абзац в разделе про правку через API и строка в «Что проверено и
когда».

Проверка: снято живыми запросами при закрытии #72 — резолюция правилась
дважды этой командой.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-13 08:04:38 +03:00
co-authored by Claude Opus 5
parent 1fb219f836
commit 41d057252e
+9
View File
@@ -78,6 +78,12 @@ tea api -X PATCH -d @patch.json repos/{owner}/{repo}/issues/<n>
Тот же приём — для чек-листа родительской карты: пункт `- [ ] #NN` тикается
правкой её тела, автоматически Gitea этого не делает.
Комментарий правится тем же способом, но путь у него свой — без номера issue:
`tea api -X PATCH -d @patch.json repos/{owner}/{repo}/issues/comments/<id>`.
Идентификатор берётся из `GET .../issues/<n>/comments`; это не порядковый номер
комментария в ленте. Нужно это чаще, чем кажется: резолюции wayfinder-тикетов
живут комментариями, и правка после ревью идёт в них.
**Отсюда общее правило.** `tea` удобен там, где команда создаёт объект или
меняет его свойство: создать issue, добавить комментарий, повесить метку,
назначить исполнителя, закрыть. Как только нужно **изменить уже написанный
@@ -159,6 +165,9 @@ issue этапа — Gitea чек-листы сама не обновляет.
## Что проверено и когда
2026-08-13: правка комментария через `repos/{owner}/{repo}/issues/comments/<id>`
снята живыми запросами при закрытии #72 — так дважды правилась резолюция тикета.
2026-08-06: правка тела issue через `tea api -X PATCH -d @файл` снята живыми
запросами при закрытии #37 — так проставлены чекбоксы самого тикета и пункт
в чек-листе карты #4. Тогда же проверено, что `tea issues edit --description`