diff --git a/tasks/dev-agent/AGENTS.md b/tasks/dev-agent/AGENTS.md index e4994e0..f4a7b21 100644 --- a/tasks/dev-agent/AGENTS.md +++ b/tasks/dev-agent/AGENTS.md @@ -17,10 +17,77 @@ ## Файлы состояния -- `tasks/todo.md` — текущий план задачи +- `tasks/todo.md` — текущий план задачи (обновляй по ходу) - `tasks/lessons.md` — уроки и правила (читать в начале каждой сессии) - `memory/YYYY-MM-DD.md` — дневник работы +## ⚡ Обязательные отчёты — ВСЕГДА, без исключений + +### Правило: каждая задача = файл отчёта + +Как только получил задачу — **сразу** создай файл отчёта: +``` +/home/node/.openclaw/workspace/tasks//reports/dev-YYYY-MM-DD-LABEL.md +``` +Где `LABEL` — короткое имя задачи (например `mart-fix`, `schema-migration`). + +Если папка `reports/` не существует — создай. + +### Структура отчёта + +```markdown +# Dev Report: <название задачи> +Дата: YYYY-MM-DD +Статус: IN PROGRESS | DONE | FAILED + +## Задача +<что попросили сделать> + +## Сделано +- [ ] шаг 1 +- [x] шаг 2 — готово + +## Изменённые файлы +- `path/to/file.py` — что изменено + +## Результат +<итог, что работает, что проверено> + +## Проблемы и решения +<что пошло не так и как решили> + +## Следующий шаг (если не завершено) +<что делать при продолжении> +``` + +### Checkpoint-ы в процессе + +При работе над задачей **обновляй отчёт после каждого крупного шага**: +- Создал DDL — записал в отчёт +- Задеплоил файл — записал +- Прогнал тест — записал результат +- Нашёл баг — записал в «Проблемы» + +Не жди конца задачи. Если сессия оборвётся — следующий Dev прочтёт отчёт и продолжит. + +### Итоговый отчёт + +В конце задачи: +1. Обнови статус на `DONE` +2. Заполни раздел «Результат» — конкретные цифры, SQL-запросы проверки, вывод тестов +3. Обнови `tasks/todo.md` — пометь задачи как выполненные +4. Запиши урок в `tasks/lessons.md` если было что-то нетривиальное + +### Резервирование прогресса + +Для длинных задач (>10 шагов) — каждые ~5 шагов делай git commit или пиши промежуточный snapshot в отчёт: +```markdown +## Checkpoint 1 (HH:MM) +- Сделано: ... +- Состояние БД: ... +- Следующий шаг: ... +``` + ## Память После каждого рабочего дня записывай в `memory/YYYY-MM-DD.md`: