[ PROMPT_NODE_26022 ]
notion-knowledge-capture
[ SKILL_DOCUMENTATION ]
# 知识捕获
将对话和笔记转换为结构化、可链接的 Notion 页面,以便于重复使用。
## 快速开始
1) 明确要捕获的内容(决策、操作指南、常见问题解答、学习心得、文档)以及目标受众。
2) 在 `reference/` 中确定正确的数据库/模板(团队 Wiki、操作指南、常见问题解答、决策日志、学习心得、文档)。
3) 使用 `Notion:notion-search` → `Notion:notion-fetch` 从 Notion 拉取任何先前的上下文(要更新/链接的现有页面)。
4) 使用数据库的模式通过 `Notion:notion-create-pages` 起草页面;包括摘要、上下文、源链接以及标签/所有者。
5) 从中心页面和相关记录进行链接;随着源内容的演变,使用 `Notion:notion-update-page` 更新状态/所有者。
## 工作流
### 0) 如果任何 MCP 调用失败,因为 Notion MCP 未连接,请暂停并进行设置:
1. 添加 Notion MCP:
- `codex mcp add notion --url https://mcp.notion.com/mcp`
2. 启用远程 MCP 客户端:
- 在 `config.toml` 中设置 `[features].rmcp_client = true` **或** 运行 `codex --enable rmcp_client`
3. 使用 OAuth 登录:
- `codex mcp login notion`
登录成功后,用户必须重启 codex。你应该完成你的回答并告知用户,以便他们在重试时可以继续第 1 步。
### 1) 定义捕获内容
- 询问目的、受众、时效性,以及这是新内容还是更新。
- 确定内容类型:决策、操作指南、常见问题解答、概念/Wiki 条目、学习心得/笔记、文档页面。
### 2) 定位目标位置
- 使用 `reference/*-database.md` 指南选择正确的数据库;确认所需的属性(标题、标签、所有者、状态、日期、关系)。
- 如果有多个候选数据库,询问用户使用哪一个;否则,在主要的 Wiki/文档数据库中创建。
### 3) 提取和结构化
- 从对话中提取事实、决策、行动和基本原理。
- 对于决策,记录备选方案、基本原理和结果。
- 对于操作指南/文档,捕获步骤、先决条件、资产/代码链接以及边缘情况。
- 对于常见问题解答,以问答形式表述,并附带简洁的答案和指向更深入文档的链接。
### 4) 在 Notion 中创建/更新
- 使用带有正确 `data_source_id` 的 `Notion:notion-create-pages`;设置属性(标题、标签、所有者、状态、日期、关系)。
- 使用 `reference/` 中的模板来结构化内容(章节标题、清单)。
- 如果要更新现有页面,请通过 `Notion:notion-update-page` 获取后进行编辑。
### 5) 链接和呈现
- 添加到中心页面、相关规范/文档和团队的关系/反向链接。
- 添加一个 sho