notion-knowledge-capture

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Knowledge Capture

知识捕获

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

将对话和笔记转换为结构化、可链接的Notion页面，以便轻松复用。

Quick start

快速开始

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

明确要捕获的内容类型（决策、操作指南、常见问题、学习笔记、文档）以及目标受众。
在
```
reference/
```
目录中找到合适的数据库/模板（团队维基、操作指南、常见问题、决策日志、学习笔记、文档）。
使用
```
Notion:notion-search
```
→
```
Notion:notion-fetch
```
从Notion中提取已有上下文（需要更新/链接的现有页面）。
利用数据库架构，通过
```
Notion:notion-create-pages
```
草拟页面；内容需包含摘要、上下文、来源链接以及标签/负责人。
从中心页面和相关记录添加链接；随着内容更新，使用
```
Notion:notion-update-page
```
更新状态/负责人。

Workflow

工作流程

0) If any MCP call fails because Notion MCP is not connected, pause and set it up:

0) 如果任何MCP调用失败是因为未连接Notion MCP，请暂停并进行设置：

Add the Notion MCP:

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

Enable remote MCP client:

Set

[features].rmcp_client = true

config.toml

or run

codex --enable rmcp_client

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.

添加Notion MCP：

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。你需要完成当前回答并告知用户，当他们再次尝试时可以继续执行步骤1。

1) Define the capture

1) 定义捕获内容

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

2) 定位目标位置

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.

使用
```
reference/*-database.md
```
指南选择正确的数据库；确认必填属性（标题、标签、负责人、状态、日期、关联关系）。
如果有多个候选数据库，请询问用户使用哪个；否则，在主维基/文档数据库中创建。

3) Extract and structure

3) 提取并结构化内容

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

4) 在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
```
.

使用正确的
```
data_source_id
```
调用
```
Notion:notion-create-pages
```
；设置属性（标题、标签、负责人、状态、日期、关联关系）。
使用
```
reference/
```
中的模板来组织内容（章节标题、清单）。
如果是更新现有页面，先通过
```
Notion:notion-fetch
```
获取内容，再使用
```
Notion:notion-update-page
```
进行编辑。

5) Link and surface

5) 链接和展示

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

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

）。