Хранилище задач переведено с локальных файлов в .scratch/ на Gitea Issues. Состояния triage стали метками Gitea. Оставшиеся английские заголовки и термины в документах для агентов переведены на русский. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
3.9 KiB
Хранилище задач: 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>, затем краткий итог со ссылкой в раздел «Принятые решения» описания карты.