74 lines
4.3 KiB
Markdown
74 lines
4.3 KiB
Markdown
# Команды для работы с задачами
|
|
|
|
Источник активных задач: [`TASKS.md`](TASKS.md).
|
|
Архив завершённых задач: [`COMPLETED_TASKS.md`](COMPLETED_TASKS.md).
|
|
|
|
Используй только две канонические команды. Регистр не важен; синонимы не
|
|
используются.
|
|
|
|
## Создание задачи
|
|
|
|
```text
|
|
Новая задача: <краткое описание>
|
|
```
|
|
|
|
Агент задаёт необходимые уточняющие вопросы и повторяет этот цикл, пока задача
|
|
не станет понятной: определены цель, границы, критерии готовности, проверка,
|
|
ограничения и следующий шаг. До этого задача не добавляется в `TASKS.md`.
|
|
После подтверждения полноты агент добавляет её со статусом `TODO`. Код и
|
|
продуктовые файлы не изменяются.
|
|
|
|
Пример:
|
|
|
|
```text
|
|
Новая задача: добавить повторную отправку письма подтверждения регистрации
|
|
```
|
|
|
|
## Выполнение задачи
|
|
|
|
```text
|
|
Выполнить задачу: ED-001
|
|
```
|
|
|
|
Агент сам выбирает режим:
|
|
|
|
- простая задача: изучить, изменить, проверить;
|
|
- обычная задача: изучить, составить короткий план, изменить, проверить;
|
|
- сложная или рискованная задача: задать блокирующие вопросы, показать план,
|
|
дождаться подтверждения, затем выполнить по этапам.
|
|
|
|
Во всех режимах агент читает задачу, меняет статус на `IN_PROGRESS`, изучает
|
|
текущий flow и callers, делает минимальный diff, запускает проверки, исправляет
|
|
ошибки и обновляет `TASKS.md`.
|
|
|
|
### Обязательная проверка стандартов кода
|
|
|
|
Перед изменением кода прочитай стандарт затрагиваемого репозитория:
|
|
|
|
- бэкенд: [`GO_STANDARD.md`](../../evening_detective_server/docs/GO_STANDARD.md);
|
|
- фронтенд: [`FRONTEND_CODE_STANDARD.md`](../../evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md).
|
|
|
|
Перед переводом задачи в `DONE` обязательно проверь весь diff задачи на
|
|
соответствие применимым требованиям стандарта. Проверка включает ручное ревью
|
|
изменённого кода: успешные тесты и линтеры не заменяют проверку правил, которые
|
|
они не контролируют. Исправь обнаруженные нарушения в рамках задачи, не расширяя
|
|
diff на посторонний код.
|
|
|
|
Запусти обязательные проверки затронутого репозитория:
|
|
|
|
- бэкенд: `gofmt` для изменённых Go-файлов и `go test ./...`;
|
|
- фронтенд: `npm run type-check`, `npm run lint`, `npm run lint:css`.
|
|
|
|
Зафиксируй результат проверки стандартов и команд в результате задачи и итоговом
|
|
сообщении. Если обязательная проверка не выполнена или остались нарушения без
|
|
разрешённого пользователем отклонения, не переводи задачу в `DONE`.
|
|
|
|
Дополнительного агента агент использует только для независимого исследования
|
|
или ревью, когда это реально сокращает риск или время.
|
|
|
|
## Общие правила
|
|
|
|
- Активные задачи хранятся в `TASKS.md`, завершённые — в `COMPLETED_TASKS.md`.
|
|
- Новые task-файлы в дочерних репозиториях не создаются.
|
|
- Агент не делает commit и push.
|