generated from VLADIMIR/template
updates
This commit is contained in:
@@ -31,3 +31,7 @@
|
||||
- бюджет **3 раунда** на цикл (план/результат), «все замечания одним списком»;
|
||||
- план/состояние — во внешнем файле (`.dsh/task-plan.md`), промпт ревью — дельта + `git diff`;
|
||||
- саморевью фактическими проверками до отправки сеньёру (поведение функций на реальных данных, сгенерированный код, арифметика).
|
||||
|
||||
## Улучшения вне скоупа (скилл todo-collect)
|
||||
|
||||
Если в ходе задачи нашлось улучшение/долг, не мешающее текущей работе — **не чини попутно**: запиши его в локальную папку `todo/` по скиллу `todo-collect` (каждая задача — отдельный файл, шаблон в скилле) и продолжай текущую задачу. Папка в `.gitignore` — это локальный журнал, не коммитится.
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
name: todo-collect
|
||||
description: Записывает найденные улучшения «вне скоупа» текущей задачи в локальную папку todo/ — каждую задачу в отдельный файл, без выполнения и без расширения scope. Загружай при работе над любой задачей (реализация, ревью, рефакторинг, исследование), чтобы не терять замечания, не мешающие текущей работе.
|
||||
whenToUse: В процессе любой задачи обнаружено улучшение, оптимизация, потенциальный баг или долг, которые не блокируют и не относятся к текущей задаче. Триггеры: замечание в коде, «на будущее» из ревью, осознанное ограничение, отложенное решение.
|
||||
---
|
||||
|
||||
# Сбор улучшений «вне скоупа» в todo/
|
||||
|
||||
## Контекст
|
||||
|
||||
В ходе задачи постоянно встречаются места, которые можно улучшить, но чинить их сейчас — значит расширять scope и рисковать текущей работой (правило «не отклоняйся молча»). Такие находки не должны теряться: они записываются в локальную папку `todo/` репозитория (в `.gitignore`, в git не попадает) — **каждая задача в свой отдельный файл**.
|
||||
|
||||
## Правила
|
||||
|
||||
1. **Записывай, не чини.** Нашёл улучшение, не мешающее текущей задаче — запиши в `todo/` и продолжай текущую работу. Не выполняй записанные задачи в текущей сессии, если пользователь явно об этом не попросил.
|
||||
2. **Одна задача — один файл.** Имя файла — kebab-case, отражающее суть: `todo/<chto-i-gde>.md` (например, `todo/mapimage-idempotent-prefix.md`). Если файл с той же сутью уже существует — дополни его, не создавай дубль.
|
||||
3. **Записывай сразу.** Не откладывай «на потом»: в конце задачи контекст уже потерян. Короткая запись по шаблону ниже занимает минуту.
|
||||
4. **Фиксируй только факты и предложения.** Без воды: что не так, где, как исправить (с оценкой риска), кто/когда нашёл.
|
||||
5. **Не перемещай и не удаляй чужие записи.** Менять статус/содержимое своей записи можно; чужие — только по договорённости.
|
||||
6. **Папка локальная.** `todo/` в `.gitignore` — не коммить, не синхронизировать. Если задача заслуживает общего трекинга — предложи пользователю перенести её в issue-трекер.
|
||||
|
||||
## Шаблон записи
|
||||
|
||||
```markdown
|
||||
# <Краткое название задачи>
|
||||
|
||||
- **Где найдено**: <файл/пакет/место в коде; в какой задаче>
|
||||
- **Дата**: <YYYY-MM-DD>
|
||||
- **Статус**: todo
|
||||
|
||||
## Проблема
|
||||
|
||||
<что именно не так, почему это проблема, при каких условиях проявится>
|
||||
|
||||
## Предложение
|
||||
|
||||
<как исправить, с указанием конкретных файлов/функций; оценка риска и объёма>
|
||||
|
||||
## Связи
|
||||
|
||||
<опционально: связанные todo-файлы, ссылки на код, замечания ревью>
|
||||
```
|
||||
|
||||
## Статусы
|
||||
|
||||
- `todo` — записано, не начато;
|
||||
- `in_progress` — кто-то взялся (укажи имя/сессию);
|
||||
- `done` — выполнено (укажи, как и когда; можно удалить файл после подтверждения).
|
||||
|
||||
## Критерии готовности записи
|
||||
|
||||
- [ ] Проблема описана так, что понятна без контекста исходной задачи.
|
||||
- [ ] Предложено конкретное исправление (или явно сказано, что решение открыто).
|
||||
- [ ] Файл лежит в `todo/` с kebab-case именем, дублей нет.
|
||||
@@ -31,6 +31,10 @@ go.sum
|
||||
.gocache/
|
||||
.gotmp/
|
||||
|
||||
# Локальный журнал улучшений «вне скоупа» текущей задачи
|
||||
# (каждая запись — отдельный файл, см. скилл todo-collect)
|
||||
todo/
|
||||
|
||||
.VSCodeCounter/
|
||||
|
||||
docker-compose-prod.yml
|
||||
Reference in New Issue
Block a user