Files
dotfiles/docs/agents/issue-tracker.md
ddadminandClaude Opus 5.5 e8bf134554 docs(agents): вести задачи в Gitea через tea
Хранилище задач переведено с локальных файлов в .scratch/ на Gitea Issues.
Состояния triage стали метками Gitea. Оставшиеся английские заголовки
и термины в документах для агентов переведены на русский.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 11:09:21 -04:00

3.9 KiB
Raw Permalink Blame History

Хранилище задач: Gitea

Задачи и спецификации этого репозитория хранятся в Gitea Issues на git.dementev.space (репозиторий ddmitry/dotfiles). Все операции — через CLI tea. Внутри клона tea сам находит репозиторий и учётную запись по git remote; если не нашёл, добавь --repo ddmitry/dotfiles.

GitVerse — только зеркало, задачи там не ведём.

Заголовки, описания и комментарии задач пишутся по-русски.

Команды

  • Создать задачу: tea issues create --title "..." --description-file - с текстом через heredoc. Метки — --labels "a,b".
  • Прочитать задачу: tea issues <номер> --comments.
  • Список задач: tea issues list --state open --labels "..." --fields index,title,labels,assignees --output json.
  • Комментарий: tea comment <номер> "...".
  • Метки: tea issues edit <номер> --add-labels "..." / --remove-labels "...". Если метки ещё нет в репозитории, создай её: tea labels create --name "..." --color "#...".
  • Закрыть: сначала комментарий с причиной, затем tea issues close <номер>.

PR как источник задач

PR как источник запросов: нет. (Поставь да, если внешние PR в этом репозитории нужно разбирать как запросы на доработку; /triage читает этот флаг.)

У задач и PR в Gitea общая нумерация: голый #42 может оказаться и тем, и другим. Проверяй через tea issues 42 или tea pulls 42.

Публикация задачи

Когда навык просит опубликовать задачу, нужно создать задачу в Gitea.

Получение задачи

Нужно выполнить tea issues <номер> --comments.

Работа /wayfinder

Карта — одна задача, дочерние задачи — отдельные задачи Gitea.

  • Карта: задача с меткой wayfinder:map; в описании — разделы «Заметки», «Принятые решения» и «Неясности».
  • Дочерняя задача: первой строкой описания — Часть #<карта>; в описании карты — список дочерних задач. Метка типа: wayfinder:<тип> (research, prototype, grilling или task).
  • Зависимости: встроенные зависимости Gitea. Добавить блокирующую задачу: tea api -X POST repos/ddmitry/dotfiles/issues/<дочерняя>/dependencies -d '{"owner":"ddmitry","repo":"dotfiles","index":<блокирующая>}'. Посмотреть: tea api repos/ddmitry/dotfiles/issues/<n>/dependencies. Задача свободна от блокировок, когда все блокирующие задачи закрыты.
  • Свободные задачи: открытые дочерние задачи карты без открытых блокирующих и без исполнителя; первой берётся та, что раньше в списке карты.
  • Взять задачу: tea issues edit <n> --add-assignees ddmitry — первым действием сессии.
  • Завершить: комментарий с ответом, tea issues close <n>, затем краткий итог со ссылкой в раздел «Принятые решения» описания карты.