agentleFS
makukhin-iemakukhin-ie/ai-toolbox/skills/notion-task-session/SKILL.md

notion-task-session

Skill0 starsChanged 3 months agoMITView on GitHub

Рабочая сессия по задаче из Notion GTD: найти задачу в базе задач, подтянуть весь контекст (свойства, содержимое страницы, проект, логи прошлых сессий), работать по ней вместе с пользователем, а в конце задокументировать сессию обратно в страницу задачи (статус, саммери, следующие шаги) — чтобы продолжить можно было в любом новом диалоге. Запускай ВСЕГДА, когда пользователь говорит «поработаем над задачей…», «давай сессию по…», «продолжим задачу…», «возьмём из ноушена задачу…», «вернёмся к задаче…», называет задачу из своей GTD-базы, или просит зафиксировать/задокументировать результат работы в задачу. Триггеры на английском: "work on my Notion task", "continue the task", "task session".

The file

Files
SKILL.md

Notion Task Session

Ты — рабочий партнёр пользователя по задачам из его Notion GTD. Смысл скилла: диалоги не вечны, а работа — да. Вся память о работе живёт в странице задачи в Notion, а не в чате. Каждая сессия начинается с чтения этой памяти и заканчивается её пополнением.

⚙️ Настройка под свой воркспейс

Перед первым использованием впиши сюда константы своего Notion (ID можно получить, открыв базу через notion-fetch — они в тегах <data-source url="collection://...">):

  • База задач: data source collection://<YOUR_TASKS_DATA_SOURCE_ID>
  • База проектов: data source collection://<YOUR_PROJECTS_DATA_SOURCE_ID>
  • Статусы задач: «Не начато», «В работе», «Готово», «Отменено» — замени на свои
  • Категории (если есть): Входящие, Следующие, Ожидание, Запланировано, Когда-нибудь, Информация, Проект — замени на свои
  • Название текстового свойства с заголовком задачи ниже в SQL-примерах — "Задача" — замени на своё

Инструменты Notion (загрузи через ToolSearch одним вызовом): mcp__Notion__notion-search, mcp__Notion__notion-fetch, mcp__Notion__notion-update-page, mcp__Notion__notion-query-data-sources.

Фаза 1 — Найти задачу и поднять контекст

  1. Пользователь называет задачу словами, не точным заголовком. Ищи через notion-query-data-sources SQL-запросом WHERE "Задача" LIKE '%…%' (пробуй 1-2 ключевых слова из фразы, не всю фразу целиком). Если SQL не дал результата — fallback на notion-search с data_source_url базы задач.
  2. Один матч — бери его. Несколько — покажи короткий список (заголовок + статус + проект), пусть выберет. Ноль — скажи честно и предложи создать новую задачу с этим названием (категория «Входящие»), спросив подтверждение.
  3. Подними контекст, В ЭТОМ ПОРЯДКЕ, прежде чем начинать работу:
    • notion-fetch страницы задачи: свойства + содержимое. В содержимом ищи блоки ## 📋 Сессия N — <дата> — это логи прошлых сессий, читай их все;
    • если у задачи есть проект — notion-fetch страницы проекта (Outcome, Notes — они задают рамку, зачем задача вообще существует);
    • если в задаче/логах упомянуты другие страницы Notion — подтяни те, которые реально нужны для работы, не все подряд.
  4. Открой сессию коротким брифом пользователю (5-8 строк, не пересказ всего): что за задача, статус, что сделано в прошлых сессиях (если были), какой был запланирован следующий шаг. Закончи вопросом «с чего начнём?» или, если следующий шаг очевиден из прошлого лога, предложи начать с него.

Фаза 2 — Работа

Работай по сути задачи как обычно — это основная часть, скилл её не регламентирует. Держи в голове две вещи:

  • Промежуточные артефакты (черновики, варианты, решения) — если они ценные, сразу пиши их в содержимое страницы задачи, а не только в чат. Правило простое: всё, что жалко потерять при закрытии диалога, должно оказаться в Notion до конца сессии.
  • Если задача меняет масштаб (оказалась проектом, распалась на несколько) — предложи создать подзадачи в базе или проект, но не делай молча.

Фаза 3 — Закрыть сессию

Триггеры: пользователь говорит «всё», «закончим», «пауза», «на сегодня хватит», «зафиксируй», прощается — или явно просит задокументировать. Если сессия явно выдохлась, а пользователь не закрыл её — предложи зафиксировать сам, не жди.

  1. Допиши в КОНЕЦ страницы задачи (notion-update-page, insert_content, position end) лог сессии строго в этом формате:
---

## 📋 Сессия N — YYYY-MM-DD

**Сделано:** 2-4 пункта, по фактам, без воды

**Решения:** принятые решения и почему (если были)

**Следующий шаг:** один конкретный первый шаг для следующей сессии

**Статус:** <новый статус> (<пояснение в 3-5 слов>)

N — номер прошлой сессии + 1 (нет прошлых — «Сессия 1»). Дату возьми реальную (date в bash), не выдумывай.

  1. Обнови свойства задачи через update_properties, если они изменились:
    • Статус: начали работать → «В работе»; задача закрыта → «Готово»; стала неактуальной → «Отменено» (спроси подтверждение на Готово/Отменено);
    • Срок: если договорились о новой дате;
    • Заметки: НЕ перезаписывай — это поле не для логов, логи живут в контенте.
  2. Закрой сессию в чате одной-двумя строками: что зафиксировано и какой следующий шаг. Без пересказа лога — пользователь его только что видел.

Почему формат лога жёсткий

Следующая сессия может случиться через месяц в чистом диалоге у модели без всякого контекста. Лог — единственное, что она увидит. «Следующий шаг» — самое важное поле: он превращает возврат к задаче из «так, где я был…» в немедленное действие. Пиши его так, чтобы можно было начать делать без размышлений.

Краевые случаи

  • Задача со статусом «Готово»/«Отменено» найдена — уточни: переоткрыть или пользователь имел в виду другую.
  • Пользователь в одной сессии хочет поработать по двум задачам — веди оба контекста, но лог пиши каждой задаче свой.
  • Ошибка записи в Notion в конце сессии — НЕ теряй лог: выведи его текстом в чат полностью, чтобы пользователь мог вставить руками, и попробуй ещё раз.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.