一次讨论说清了问题，下周却又从头解释，这时可以用 notion-knowledge-capture。给它讨论记录、目标读者和知识库位置，它会选择适合的页面结构，并先寻找已有相关内容，帮助你把信息接到团队原来的知识网络里。
安装与准备
本文介绍 openai/skills 保留的独立 Skill 版本。该仓库已弃用，当前官方示例转至 openai/plugins；这里的步骤对应本页链接的旧仓库版本，不代表最新插件。
在 Codex 对话框输入下面这一行；它不是终端命令。安装后若找不到该 Skill，重启 Codex 再试。
$skill-installer notion-knowledge-capture
- 本地 Codex 与可用的 Notion MCP 连接
- 已通过 OAuth 授权的 Notion 工作区
- 目标页面或数据库的访问与编辑权限
若尚未连接，在 ~/.codex/config.toml 中加入下面配置，然后在终端运行 codex mcp login notion 完成 OAuth。当前 Notion 文档不要求旧 Skill 中的 rmcp_client 开关。已安装可用 Notion 连接时无需重复配置。 [4]
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
第一次怎么用
替换目标 Notion 页面链接后，可以这样开始：
$notion-knowledge-capture
把本次关于退款规则的讨论整理成 Notion 决策记录。目标页面：[粘贴知识库链接]。先查是否已有同主题记录；保留决定、替代方案、理由和待确认问题。负责人未明确时不要猜。先给我页面预览和目标位置，确认后再创建或更新。
接下来怎样推进
-
决定记录形式。 决策记录要有取舍理由，操作指南要有步骤和前提，FAQ 则围绕读者会提出的问题组织。
-
找到准确落点。 先搜索并读取相关页面，确定是更新旧文还是新建；写入数据库前检查标题、状态、标签和关联等实际属性。
-
写入并补链接。 把来源讨论和相关规范附在页面中，再返回新页面链接。若产生后续任务，另行说明负责人和期限是否已确定。
从一段讨论提炼出可复用的知识
给出原始讨论链接或允许读取的笔记，并说明它是决策记录、操作说明还是 FAQ。例如一次上线复盘，应提取“决定了什么、为什么、谁负责、什么时候回看”，而不是把聊天逐句搬到 Notion。先让 Agent 搜索已有页面：若同主题已经有说明，优先提出更新位置；若新建页面，先核对目标数据库真实存在的标题、状态、负责人和关联属性。
可以输入：“把这段支付回调排障讨论整理成操作说明。先列出你找到的既有页面和目标数据库；只保留已确认的症状、排查步骤和恢复条件，未知原因放在待确认。写入后返回页面链接。” 这类提示明确了读者、目标和证据边界，也能避免把临时猜测写成正式规范。
写入后如何检查
打开返回的 Notion 页面，核对标题是否可搜索、步骤是否能由新人照做、原始记录和相关规范是否可点击。决策记录要区分决定与备选方案；FAQ 的每个回答应能独立理解。若目标库缺少必需属性或权限不足，先保留整理好的内容并指出阻碍，不能声称页面已创建。
交付后先检查什么
打开结果页面，看一个未参加讨论的同事能否理解“决定了什么、为什么、什么时候仍需复核”。检查已有文档是否被重复创建、链接能否打开，以及未决定事项是否仍保持为待确认。
人员属性先解析真实用户
把讨论整理进带有 Owner、Deciders 等人员属性的数据库时，不要原样复制参考示例里的 current_user、tech_lead 或 eng_team。这些是说明性的名字，不是可提交的 Notion 用户 ID。写入前先查出实际用户标识；同名多人时停下来确认，再把最终页面的人员、决定和原讨论链接逐一核对。
常见卡点
搜索不到页面。 先在同一 Notion 账号里打开目标链接，确认工作区和权限；换关键词并不能解决授权问题。
数据库写入失败。 让 Codex 重新读取目标数据源的属性，不要凭另一个库的模板猜字段名。
原始对话缺少结论。 先保留为讨论纪要或待决问题，等你补充后再转成决策。