64 lines
3.7 KiB
Markdown
64 lines
3.7 KiB
Markdown
# Трекер задач: Gitea
|
|
|
|
Задачи и спецификации этого репозитория хранятся в Gitea Issues:
|
|
`git.dementev.space/ddmitry/mini-lakehouse-lab`. Для работы с ними используй
|
|
CLI `tea`.
|
|
|
|
## Основные команды
|
|
|
|
- **Создать задачу**:
|
|
`tea issues create --title "..." --description "..."`
|
|
- **Прочитать задачу вместе с комментариями**:
|
|
`tea issues <номер> --comments --output yaml`
|
|
- **Получить список задач**:
|
|
`tea issues list --state open --output json`; при необходимости добавь
|
|
фильтры, например `--labels`
|
|
- **Добавить комментарий**:
|
|
`tea comments add <номер> --description "..."`
|
|
- **Добавить или удалить метки**:
|
|
`tea issues edit <номер> --add-labels "..."` или
|
|
`tea issues edit <номер> --remove-labels "..."`
|
|
- **Назначить исполнителя**:
|
|
`tea issues edit <номер> --add-assignees "<имя пользователя>"`
|
|
- **Закрыть задачу**: сначала опубликуй итоговый комментарий через
|
|
`tea comments add`, затем выполни `tea issues close <номер>`
|
|
|
|
Запускай команды из каталога репозитория: `tea` определит Gitea-подключение и
|
|
репозиторий по Git remote.
|
|
|
|
## Pull request как источник задач для триажа
|
|
|
|
**Обрабатывать pull request как входящие задачи: нет.**
|
|
|
|
Измени значение на `да`, если в будущем репозиторий начнёт рассматривать
|
|
внешние pull request как запросы на изменение. Навык `/triage` читает эту
|
|
настройку.
|
|
|
|
## Когда навык просит опубликовать задачу в трекере
|
|
|
|
Создай Gitea Issue с помощью `tea issues create`.
|
|
|
|
## Когда навык просит получить связанную задачу
|
|
|
|
Выполни `tea issues <номер> --comments --output yaml`.
|
|
|
|
## Операции Wayfinder
|
|
|
|
Навык `/wayfinder` использует одну задачу-карту и связанные с ней дочерние
|
|
задачи.
|
|
|
|
- **Карта**: задача с меткой `wayfinder:map`, содержащая разделы Notes,
|
|
Decisions-so-far и Fog
|
|
- **Дочерняя задача**: задача, описание которой начинается со строки
|
|
`Part of #<номер карты>` и содержит метку типа `wayfinder:<тип>`:
|
|
`research`, `prototype`, `grilling` или `task`
|
|
- **Блокировка**: строка `Blocked by: #<номер>, #<номер>` в начале описания;
|
|
задача разблокирована, когда закрыты все перечисленные задачи
|
|
- **Фронтир**: найди открытые дочерние задачи карты, исключи назначенные и
|
|
заблокированные, затем выбери первую по порядку в карте
|
|
- **Взять в работу**: назначь исполнителя командой
|
|
`tea issues edit <номер> --add-assignees "<имя пользователя>"`; это первая
|
|
запись в трекер в рамках сессии
|
|
- **Завершить**: опубликуй ответ в комментарии, закрой дочернюю задачу и добавь
|
|
в раздел Decisions-so-far карты ссылку на сохранённый контекст
|