前言¶

用 Cursor、Codex 这类 AI 编程工具写代码时，对话里经常会留下不少「值钱」的内容：一次架构选型的理由、一段上线步骤、几个反复被问到的坑。问题是，这些内容往往停在聊天窗口里——过几天想找，只能翻历史记录；新人要上手，又得再问一遍。

Notion 本来就是很多团队的 Wiki 和文档中心。若能在对话结束时，把结论整理成结构化页面，并挂到对应数据库里，知识才会真正沉淀下来。notion-knowledge-capture 就是做这件事的 Agent Skill：把聊天与笔记转成可链接、可复用的 Notion 页面。

这是什么¶

notion-knowledge-capture 出自 OpenAI 的 Agent Skills 目录（openai/skills 仓库中的 .curated 精选技能），定位很明确：把对话与决策捕获为结构化 Notion 页面，适合写成团队 Wiki、How-To、决策记录（ADR）、FAQ、学习笔记或正式文档。

它依赖 Notion 官方托管的 MCP 服务（https://mcp.notion.com/mcp），通过 notion-search、notion-fetch、notion-create-pages、notion-update-page 等工具读写工作区。Skill 本身主要是一份带工作流与模板的 SKILL.md，再加上 reference/ 数据库说明和 examples/ 示例；Agent 读到后按流程执行。

说明一点：openai/skills 仓库 README 已提示该仓库进入弃用状态，后续 Codex 插件/技能示例更推荐看 OpenAI Plugins 相关文档；但本 Skill 的 SKILL.md、参考模板与示例仍可在当前目录获取，安装命令在 skills.sh、MCPServers 等目录页也仍指向同一路径。以一手 SKILL.md 为准即可。

核心功能与亮点¶

根据官方 SKILL.md 与配套文件，能力可以概括为下面几块。

1、六类内容模板
reference/ 里为不同用途准备了数据库说明，包括：

team-wiki-database.md：团队 Wiki
how-to-guide-database.md：操作指南
faq-database.md：FAQ
decision-log-database.md：决策日志
documentation-database.md：文档库
learning-database.md：学习/复盘笔记

另有 database-best-practices.md，讲属性命名、Owner、Status、Tags 等通用约定。

2、固定五步工作流
先明确「要捕获什么、给谁看」，再选对数据库，从对话里抽出事实/决策/步骤，用 Notion MCP 创建或更新页面，最后回链到 Hub 页、补上摘要与负责人。不是把聊天原文原样贴进 Notion，而是按类型结构化。

3、先搜再写，避免重复页
官方 Quick Start 要求先用 Notion:notion-search，再用 Notion:notion-fetch 拉取已有页面或库结构，确认是新建还是更新，并拿到正确的属性名与 data_source_id。

4、可发现性
创建后还会更新 Hub、加 relation/backlink；若有后续事项，可在相关任务库里建任务并互链。agents/openai.yaml 里的默认提示词也强调：捕获决策、行动项，以及已知的负责人（owners）。

安装与启用¶

这类 Skill 基于通用 SKILL.md 格式，可在支持 Agent Skills 的工具里使用。安装方式以目录页与仓库说明为准。

安装 Skill¶

跨工具较常见的安装命令（skills.sh / MCPServers 目录页均给出）：

npx skills add https://github.com/openai/skills --skill notion-knowledge-capture

在 Codex 中，仓库 README 说明可用内置的 $skill-installer 按名称安装 curated 技能，例如：

$skill-installer notion-knowledge-capture

安装后按所用工具要求重启 Agent，以便发现新 Skill。Cursor 侧安装成功后，技能目录一般会出现在项目的 .cursor/skills/notion-knowledge-capture（以 CLI 实际落盘为准）。

连接 Notion MCP（必需）¶

没有 Notion MCP，Skill 无法真正读写页面。官方 SKILL.md 针对 Codex 的步骤是：

codex mcp add notion --url https://mcp.notion.com/mcp

启用远程 MCP 客户端（二选一）：

# config.toml
[features]
rmcp_client = true

或：

codex --enable rmcp_client

然后 OAuth 登录：

codex mcp login notion

登录成功后需要重启 Codex，再继续捕获流程。

若你主要用 Cursor，可按 Notion 官方 MCP 文档配置。全局或项目级 .cursor/mcp.json 示例：

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

保存并重启 Cursor，首次调用 Notion 工具时完成 OAuth。Claude Code 可用：

claude mcp add --transport http notion https://mcp.notion.com/mcp

再在会话里用 /mcp 完成授权。

Notion 推荐使用托管 MCP（https://mcp.notion.com/mcp），开源的本地 notion-mcp-server 已不再积极维护。

典型用法示例¶

Skill 自带 examples/，下面压缩自官方「决策捕获」与「How-To」示例，便于对照自己的提示词。

1. 把架构讨论写成决策记录¶

用户可以说：

把我们「客户 API 从 REST 迁到 GraphQL」的决定写进 Notion 决策库，
补上备选方案、理由、影响面和负责人。

Agent 大致会：

从对话抽出 Decision / Context / Alternatives / Rationale
Notion:notion-search，例如查询 "architecture decisions" 或 "ADR"
Notion:notion-fetch 拿到库属性（如 Decision、Date、Status、Domain、Impact 等）
Notion:notion-create-pages，指定正确的 data_source_id，写入标题与属性，正文按 ADR 结构展开
从 Architecture Wiki 等 Hub 页加回链

官方示例里创建页面时的调用形态类似：

Notion:notion-create-pages
parent: { data_source_id: "decision-log-collection-id" }
pages: [{
  properties: {
    "Decision": "Migrate to GraphQL API",
    "date:Date:start": "2025-10-16",
    "Status": "Accepted",
    "Domain": "Architecture",
    "Impact": "High"
  },
  content: "（含 Context / Decision / Options / Consequences / Plan）"
}]

实际属性名必须以你工作区里 notion-fetch 返回的 schema 为准，不要照抄占位 id。

2. 把上线讨论收成 How-To¶

用户可以说：

把刚才关于生产环境发布的讨论存成 How-To，
写上前置条件、步骤、验证清单和排障，并挂到工程 Wiki。

官方示例会整理成：Overview & Prerequisites → 编号步骤 → Verification → Troubleshooting → Related Docs，创建后再用 Notion:notion-update-page 把链接插回 Wiki 索引页。

3. 直接用默认意图¶

agents/openai.yaml 提供的默认提示词是：

Capture this conversation into structured Notion pages with decisions,
action items, and owners when known.

适合会话结束后一键沉淀：有决策就进决策库，有步骤就进 How-To，并尽量带上 Owner。

适用场景与注意事项¶

比较适合：

团队已用 Notion 做 Wiki / ADR / FAQ，希望把 AI 编程会话里的结论自动入库
需要固定版式：决策要写备选方案，How-To 要写前置条件与排障
多人协作，依赖 Tags、Owner、Status、Hub 回链做发现与责任追踪

使用时注意：

必须先连好 Notion MCP，并完成 OAuth；权限以你在 Notion 工作区能访问的范围为界。
先 fetch schema 再写属性；属性名、类型、data_source_id 因库而异，硬编码容易失败。
多个候选库时要选库；Skill 要求不确定时询问用户，而不是随便写进某一个库。
适合结构化知识，不适合整段聊天日志搬家；敏感信息入库前应自行脱敏。
仓库状态：写文章时 openai/skills README 已标注 deprecated，长期维护与分发渠道可能迁移；安装前建议再看一眼官方目录与 Notion MCP 文档是否有更新。

小结¶

notion-knowledge-capture 把「AI 写代码时聊出来的知识」接到 Notion 的结构化知识库上：选对库、抽结构、创建/更新页面、再挂回 Hub。对已经用 Notion 做团队文档的工程组来说，这是一条很直接的「对话 → Wiki」工作流。

官方目录：

https://github.com/openai/skills/tree/main/skills/.curated/notion-knowledge-capture

Notion MCP 接入说明：

https://developers.notion.com/guides/mcp/get-started-with-mcp

用 notion-knowledge-capture 把 AI 对话沉淀成 Notion 知识库

前言¶

这是什么¶

核心功能与亮点¶

安装与启用¶

安装 Skill¶

连接 Notion MCP（必需）¶

典型用法示例¶

1. 把架构讨论写成决策记录¶

2. 把上线讨论收成 How-To¶

3. 直接用默认意图¶

适用场景与注意事项¶

小结¶

精选优惠券

用 notion-knowledge-capture 把 AI 对话沉淀成 Notion 知识库

前言¶

这是什么¶

核心功能与亮点¶

安装与启用¶

安装 Skill¶

连接 Notion MCP（必需）¶

典型用法示例¶

1. 把架构讨论写成决策记录¶

2. 把上线讨论收成 How-To¶

3. 直接用默认意图¶

适用场景与注意事项¶

小结¶

精选优惠券

相关文章