用途：当 Notion 作为规格、运行手册、项目跟踪或知识管理的记录系统时，用此技能完成页面与数据库的创建、更新、检索和评论管理。
主要能力：支持搜索内容、读取页面、创建或更新页面与数据库、管理评论、读取用户上下文。官方文档列出两种 MCP 接入方式：托管远程端点 https://mcp.notion.com/mcp（OAuth 认证）与本地 stdio 包 @notionhq/notion-mcp-server（内部集成令牌）。工具名称可能因 MCP 宿主略有差异，但能力稳定。
使用方式：先确认客户端是否暴露托管 Notion MCP 或本地 stdio 连接；创建前先读取或搜索已有页面避免重复；跟踪类工作用数据库，长文用页面；属性保持简单，如 owner、status、last reviewed、tags。若当前客户端不支持 MCP，可退回本地准备：用 Markdown 或 JSON 起草内容，借助 scripts/notion-templates.js 与 Notion 网页界面发布，并优先使用本技能提供的页面与数据库模板。跨客户端可移植：GitHub Copilot 放在可见技能路径或写入项目指令；Claude Code 放在本地技能目录或兼容插件源；Codex 安装或同步到 $CODEX_HOME/skills/notion-docs 并在重大变更后重启。
适用场景：创建或更新 Notion 页面、构建项目跟踪器或工程知识库、整理规格与 ADR 及入职文档、添加评审评论或使用数据库驱动的工作流。
限制：官方当前记录集成平均速率限制为每秒 20 个请求。若宿主未暴露 MCP，不得声称使用了 MCP 操作。需避免只面向作者写作、跳过具体示例或命令、放任链接截图版本漂移等反模式。完成前应验证受众、目的、事实来源与新鲜度要求，并确认声明、链接、命令、示例与截图已验证或明确标注未验证。