Files
evening_detective_server/.dsh/skills/todo-collect/SKILL.md
T
2026-08-30 21:40:50 +07:00

4.7 KiB
Raw Blame History


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-трекер.

Шаблон записи

# <Краткое название задачи>

- **Где найдено**: <файл/пакет/место в коде; в какой задаче>
- **Дата**: <YYYY-MM-DD>
- **Статус**: todo

## Проблема

<что именно не так, почему это проблема, при каких условиях проявится>

## Предложение

<как исправить, с указанием конкретных файлов/функций; оценка риска и объёма>

## Связи

<опционально: связанные todo-файлы, ссылки на код, замечания ревью>

Статусы

  • todo — записано, не начато;
  • in_progress — кто-то взялся (укажи имя/сессию);
  • done — выполнено (укажи, как и когда; можно удалить файл после подтверждения).

Критерии готовности записи

  • Проблема описана так, что понятна без контекста исходной задачи.
  • Предложено конкретное исправление (или явно сказано, что решение открыто).
  • Файл лежит в todo/ с kebab-case именем, дублей нет.