iiuniversitet.ruЦентр обучения нейросетямОткрыть каталог

Фиксация знаний в Notion

Превращает переписку и заметки в структурированные страницы Notion: вики, инструкции, решения и FAQ с нужными связями.

СкиллOpenAI (партнёр: Notion)CodexMITНужен терминалПроверка не требуется
Что делает
Превращает переписку и заметки в структурированные страницы Notion: вики, инструкции, решения и FAQ с нужными связями.
Когда брать
Когда нужно оформить чаты и заметки как запись в вики, инструкцию, решение или FAQ в Notion.
Когда не брать
Если Notion не подключён и войти в него через OAuth нельзя.
Пример запроса
Оформи итоги нашего обсуждения как запись в журнале решений в Notion со ссылками на связанные страницы.
Нужно подключить
Notion (MCP-сервер)

Как включить

  1. Скачайте архив и распакуйте его.
  2. Положите папку notion-knowledge-capture в ~/.agents/skills/.
  3. Вызовите скилл командой $notion-knowledge-capture или найдите его через /skills.

Текст

---
name: notion-knowledge-capture
description: Превращай переписку и решения в структурированные страницы Notion; используй, когда нужно оформить чаты и заметки как статьи вики, инструкции, решения или FAQ с правильными связями.
metadata:
  short-description: Capture conversations into structured Notion pages
---

Фиксация знаний

Превращай переписку и заметки в структурированные связанные страницы Notion, которые легко использовать повторно.

Быстрый старт

  1. Уточни, что нужно зафиксировать (решение, инструкцию, FAQ, вывод, документацию) и для какой аудитории.
  2. Определи подходящую базу данных или шаблон в reference/ (вики команды, инструкция, FAQ, журнал решений, обучение, документация).
  3. Подтяни предыдущий контекст из Notion через Notion:notion-search → Notion:notion-fetch (существующие страницы, которые нужно обновить или на которые нужно сослаться).
  4. Составь черновик страницы через Notion:notion-create-pages по схеме базы данных; включи краткое резюме, контекст, ссылки на источники, теги и ответственных.
  5. Добавь ссылки с главных страниц и связанных записей; по мере развития источника обновляй статус и ответственных через Notion:notion-update-page.

Рабочий процесс

0) Если какой-либо вызов MCP не удался из-за того, что MCP Notion не подключён, остановись и настрой его:

  1. Добавь MCP Notion:
  2. codex mcp add notion --url https://mcp.notion.com/mcp
  3. Включи удалённый клиент MCP:
  4. Задай [features].rmcp_client = true в config.toml или запусти codex --enable rmcp_client
  5. Войди через OAuth:
  6. codex mcp login notion

После успешного входа пользователю придётся перезапустить codex. Закончи ответ и сообщи ему об этом, чтобы при следующем обращении он мог продолжить с шага 1.

1) Определи, что фиксируем

  • Спроси о цели, аудитории, актуальности и о том, новая это запись или обновление.
  • Определи тип содержимого: решение, инструкция, FAQ, понятие или статья вики, вывод или заметка, страница документации.

2) Найди место назначения

  • Выбери нужную базу данных по руководствам reference/*-database.md; подтверди обязательные свойства (название, теги, ответственный, статус, дата, связи).
  • Если баз-кандидатов несколько, спроси пользователя, какую использовать; иначе создавай запись в основной базе вики или документации.

3) Извлеки и структурируй

  • Извлеки из переписки факты, решения, действия и обоснования.
  • Для решений записывай альтернативы, обоснование и итоги.
  • Для инструкций и документации фиксируй шаги, предварительные условия, ссылки на материалы и код, а также крайние случаи.
  • Для FAQ формулируй вопросы и ответы: ответы краткие, со ссылками на более подробные документы.

4) Создай или обнови в Notion

  • Используй Notion:notion-create-pages с правильным data_source_id; задай свойства (название, теги, ответственный, статус, даты, связи).
  • Используй шаблоны из reference/, чтобы структурировать содержимое (заголовки разделов, чек-листы).
  • Если обновляешь существующую страницу, сначала получи её, а затем правь через Notion:notion-update-page.

5) Свяжи и сделай заметной

  • Добавь связи и обратные ссылки на главные страницы, связанные спецификации и документы, а также команды.
  • Добавь краткое резюме или журнал изменений для будущих читателей.
  • Если есть последующие задачи, создай их в нужной базе данных и свяжи.

Справочники и примеры

  • reference/ — схемы баз данных и шаблоны (например, team-wiki-database.md, how-to-guide-database.md, faq-database.md, decision-log-database.md, documentation-database.md, learning-database.md, database-best-practices.md).
  • examples/ — приёмы фиксации на практике (например, decision-capture.md, how-to-guide.md, conversation-to-faq.md).

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/notion-knowledge-capture, лицензия MIT. Изменения: перевод на русский язык.

Оригинал на английском
---
name: notion-knowledge-capture
description: Capture conversations and decisions into structured Notion pages; use when turning chats/notes into wiki entries, how-tos, decisions, or FAQs with proper linking.
metadata:
  short-description: Capture conversations into structured Notion pages
---

# Knowledge Capture

Convert conversations and notes into structured, linkable Notion pages for easy reuse.

## Quick start
1) Clarify what to capture (decision, how-to, FAQ, learning, documentation) and target audience.
2) Identify the right database/template in `reference/` (team wiki, how-to, FAQ, decision log, learning, documentation).
3) Pull any prior context from Notion with `Notion:notion-search` → `Notion:notion-fetch` (existing pages to update/link).
4) Draft the page with `Notion:notion-create-pages` using the database’s schema; include summary, context, source links, and tags/owners.
5) Link from hub pages and related records; update status/owners with `Notion:notion-update-page` as the source evolves.

## Workflow
### 0) If any MCP call fails because Notion MCP is not connected, pause and set it up:
1. Add the Notion MCP:
   - `codex mcp add notion --url https://mcp.notion.com/mcp`
2. Enable remote MCP client:
   - Set `[features].rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client`
3. Log in with OAuth:
   - `codex mcp login notion`

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

### 1) Define the capture
- Ask purpose, audience, freshness, and whether this is new or an update.
- Determine content type: decision, how-to, FAQ, concept/wiki entry, learning/note, documentation page.

### 2) Locate destination
- Pick the correct database using `reference/*-database.md` guides; confirm required properties (title, tags, owner, status, date, relations).
- If multiple candidate databases, ask the user which to use; otherwise, create in the primary wiki/documentation DB.

### 3) Extract and structure
- Extract facts, decisions, actions, and rationale from the conversation.
- For decisions, record alternatives, rationale, and outcomes.
- For how-tos/docs, capture steps, pre-reqs, links to assets/code, and edge cases.
- For FAQs, phrase as Q&A with concise answers and links to deeper docs.

### 4) Create/update in Notion
- Use `Notion:notion-create-pages` with the correct `data_source_id`; set properties (title, tags, owner, status, dates, relations).
- Use templates in `reference/` to structure content (section headers, checklists).
- If updating an existing page, fetch then edit via `Notion:notion-update-page`.

### 5) Link and surface
- Add relations/backlinks to hub pages, related specs/docs, and teams.
- Add a short summary/changelog for future readers.
- If follow-up tasks exist, create tasks in the relevant database and link them.

## References and examples
- `reference/` — database schemas and templates (e.g., `team-wiki-database.md`, `how-to-guide-database.md`, `faq-database.md`, `decision-log-database.md`, `documentation-database.md`, `learning-database.md`, `database-best-practices.md`).
- `examples/` — capture patterns in practice (e.g., `decision-capture.md`, `how-to-guide.md`, `conversation-to-faq.md`).

Источник: openai/skills / notion-knowledge-capture ↗. Ссылка проверена 2026-10-10.