name: notion description: 搜索、读取、创建和更新 Notion 页面和数据库。支持知识捕获、会议准备、研究文档和从规范到任务的工作流程。

Notion

可用工具

notion_search(query?, filter_type?, page_size?): 在所有可访问的页面和数据库中搜索。
- query (字符串, 可选): 搜索文本。空字符串返回所有可访问页面。
- filter_type (字符串, 可选): "page" 或 "database"。使用 "database" 列出数据库。
- page_size (整数, 可选, 默认: 10, 最大: 100)
notion_fetch(page_id, include_block_ids?): 以可读的 Markdown 格式获取页面的完整内容（元数据 + 所有块在一次调用中）。
- page_id (字符串, 必需): 页面或数据库条目 ID。
- include_block_ids (布尔值, 可选, 默认: false): 如果为 true，附加每个块的 ID 作为 。当需要使用 notion_update_block 更新特定块时使用此功能。
- 返回: 标题、URL、最后编辑时间以及完整的 Markdown 正文。
notion_create_page(parent_type, parent_id, title, properties_json?, content_markdown?): 创建新页面。
- parent_type (字符串, 必需): "database"、"page" 或 "workspace"（工作空间根目录）
- parent_id (字符串, 必需): 父级 UUID — 当 parent_type="workspace" 时忽略
- title (字符串, 必需): 页面标题
- properties_json (字符串, 可选): 数据库属性作为 JSON 字符串 — 例如 '{"Status": {"select": {"name": "In Progress"}}}'
- content_markdown (字符串, 可选): 初始正文内容作为 Markdown（见下面的 Markdown 支持）
notion_update_page(page_id, properties_json, archived?): 更新页面属性（仅元数据/数据库字段，不包括内容块）。
- page_id (字符串, 必需)
- properties_json (字符串, 必需): 属性作为 JSON 字符串
- archived (布尔值, 可选): true 归档，false 取消归档
notion_update_block(block_id, content_markdown): 替换特定现有块的内容。
- block_id (字符串, 必需): 块 ID — 通过 notion_fetch(include_block_ids=True) 获取
- content_markdown (字符串, 必需): 新内容作为单行 Markdown（仅使用第一个块）
notion_append_blocks(page_id, content_markdown): 将新内容块附加到现有页面的末尾。
- page_id (字符串, 必需)
- content_markdown (字符串, 必需): 要附加的 Markdown 内容（见下面的 Markdown 支持）

Markdown 支持

notion_create_page (content_markdown) 和 notion_append_blocks 都支持：

语法	块类型
`# Title` / `## Heading` / `### Sub`	heading_1 / heading_2 / heading_3
`- item` 或 `* item`	bulleted_list_item
`1. item`	numbered_list_item
`- [ ] task`	to_do (未勾选)
`- [x] task`	to_do (已勾选)
` ```python
code
``` `	带语言的代码块
`> text`	引用
`---`	分隔线
`bold`	粗体内联
`italic`	斜体内联
`code`	内联代码

常见工作流程

查找并阅读页面：

1. notion_search(query="页面名称") → 获取页面 id
2. notion_fetch(page_id) → 阅读完整内容

创建带有内容的新页面：

notion_create_page(
  parent_type="page",
  parent_id="<父页面-id>",
  title="我的页面",
  content_markdown="## 概述

内容在这里..."
)

向现有页面添加内容：

notion_append_blocks(
  page_id="<页面-id>",
  content_markdown="## 新部分

- 点 1
- 点 2"
)

编辑特定块：

1. notion_fetch(page_id, include_block_ids=True)
   → ## 旧标题  <!-- id:abc-123 -->
2. notion_update_block(block_id="abc-123", content_markdown="## 新标题")

列出数据库：

notion_search(filter_type="database")

使用案例指南

对于特定的工作流程模式，加载参考文件：

knowledge-capture.md — 将对话见解、决策和操作指南保存到 Notion 维基和数据库
meeting-intelligence.md — 通过收集 Notion 上下文并创建预读材料和议程来准备会议材料
research-documentation.md — 在 Notion 页面中研究、综合发现并撰写结构化报告
spec-to-implementation.md — 将规范页面转化为实施计划、任务和进度跟踪

使用以下方式加载参考：skill_dispatcher("notion", reference="knowledge-capture.md")