notion-knowledge-capture✓ تایید شده

محتوای SKILL.md

---
name: notion-knowledge-capture
description: 将对话和讨论转换为 Notion 中的结构化文档页面。从聊天上下文中捕获见解、决策和知识，进行适当格式化，并以适当的组织和链接方式保存到 wiki 或数据库中，以便于发现。
---

# 知识捕获

将对话、讨论和见解转换为 Notion 工作区中的结构化文档。从聊天上下文中捕获知识，对其进行适当格式化，并将其保存到正确的位置，同时进行适当的组织和链接。

## 快速开始

当被要求将信息保存到 Notion 时：

1. **提取内容**：从对话上下文中识别关键信息
2. **结构化信息**：组织成适当的文档格式
3. **确定位置**：使用 `Notion:notion-search` 查找合适的 wiki 页面/数据库
4. **创建页面**：使用 `Notion:notion-create-pages` 保存内容
5. **使其可发现**：从相关中心页面链接，添加到数据库，或更新 wiki 导航，以便其他人可以找到它

## 知识捕获工作流程

### 步骤 1：识别要捕获的内容

```
从对话上下文中提取：
- 关键概念和定义
- 做出的决策及其理由
- 操作信息和程序
- 重要见解或学习成果
- 问答对
- 示例和用例
```

### 步骤 2：确定内容类型

```
对知识进行分类：
- 概念/定义
- 操作指南
- 决策记录
- 常见问题条目
- 会议摘要
- 学习/事后分析
- 参考文档
```


### 步骤 3：结构化内容

```
根据内容类型进行适当格式化：
- 使用模板以保持一致性
- 添加清晰的标题和章节
- 在有帮助的地方包含示例
- 添加相关元数据
- 链接到相关页面
```


### 步骤 4：确定目标位置

```
保存位置：
- Wiki 页面（通用知识库）
- 特定项目页面（项目特定知识）
- 文档数据库（结构化文档）
- 常见问题数据库（问题和答案）
- 决策日志（架构/产品决策）
- 团队 wiki（团队特定知识）
```

### 步骤 5：创建页面

```
使用 Notion:notion-create-pages：
- 设置适当的标题
- 使用模板中的结构化内容
- 如果在数据库中，设置属性
- 添加标签/类别
- 链接到相关页面
```

### 步骤 6：使内容可发现

```
链接新页面以便其他人可以找到它：

1. 更新中心/索引页面：
   - 添加到 wiki 目录页面的链接
   - 从相关项目页面添加链接
   - 从类别/主题页面添加链接（例如，"工程文档"）
   
2. 如果页面在数据库中：
   - 设置适当的标签/类别
   - 设置状态（例如，"已发布"）
   - 添加到相关视图
   
3. 可选更新父页面：
   - 如果保存在项目下，添加到项目的"文档"部分
   - 如果在团队 wiki 中，确保从团队主页链接

示例：
Notion:notion-update-page
page_id: "team-wiki-homepage-id"
command: "insert_content_after"
selection_with_ellipsis: "## 操作指南..."
new_str: "- <mention-page url='...'>如何部署到生产环境</mention-page>"
```

此步骤确保知识不会成为"孤岛" - 它与工作区的导航结构正确连接。

## 内容类型

根据内容选择适当的结构：

**概念**：概述 → 定义 → 特征 → 示例 → 用例 → 相关内容

**操作指南**：概述 → 先决条件 → 步骤（编号）→ 验证 → 故障排除 → 相关内容

**决策**：背景 → 决策 → 理由 → 考虑的选项 → 后果 → 实施

**常见问题**：简短回答 → 详细解释 → 示例 → 何时使用 → 相关问题

**学习**：发生了什么 → 做得好的地方 → 不足之处 → 根本原因 → 学习成果 → 行动


## 目标位置模式

**通用 Wiki**：独立页面 → 添加到索引 → 标记 → 从相关页面链接

**项目 Wiki**：项目页面的子页面 → 从项目概述链接 → 用项目名称标记

**文档数据库**：使用属性（标题、类型、类别、标签、最后更新、所有者）

**决策日志数据库**：使用属性（决策、日期、状态、领域、决策者、影响）

**常见问题数据库**：使用属性（问题、类别、标签、最后审查、有用计数）

有关数据库选择指南和单独的模式文件，请参阅 [reference/database-best-practices.md](reference/database-best-practices.md)。

## 从对话中提取内容

**聊天讨论**：关键点、结论、资源、行动项、问答

**问题解决**：问题陈述、尝试的方法、解决方案、为什么有效、未来考虑

**知识分享**：解释的概念、示例、最佳实践、常见陷阱、资源

**决策讨论**：问题、选项、权衡、决策、理由、下一步

## 格式化最佳实践

**结构**：一致使用 `#`（标题）、`##`（章节）、`###`（小节）

**写作**：从概述开始，使用项目符号，保持段落简短，添加示例

**链接**：链接相关页面、提及人员、引用资源、创建双向链接

**元数据**：包括日期、作者、标签、状态

**可搜索性**：清晰的标题、自然关键词、常见搜索标签、图片替代文本

## 索引和组织

**Wiki 索引**：按章节组织（入门、操作指南、参考、常见问题、决策）并包含页面链接

**类别页面**：创建包含概述、文档链接和最近更新的着陆页面

**标记策略**：为技术/工具、主题、受众和状态使用一致的标签

## 更新管理

**创建新内容**：内容充实（>2 段）、将被多次引用、知识库的一部分、需要独立发现

**更新现有内容**：添加到现有主题、更正信息、扩展概念、更新变更

**版本控制**：为重大变更添加更新历史部分（日期、作者、更改内容、原因）

## 最佳实践

1. **及时捕获**：在上下文新鲜时记录
2. **一致结构**：对相似内容使用模板
3. **广泛链接**：连接相关知识
4. **为发现而写**：使用可搜索的标题和标签
5. **包含上下文**：为什么这很重要、何时使用
6. **添加示例**：具体示例有助于理解
7. **维护**：定期审查和更新
8. **获取反馈**：询问文档是否有帮助

## 高级功能

**文档数据库**：有关数据库模式，请参阅 [reference/database-best-practices.md](reference/database-best-practices.md)。

## 常见问题

**"不确定保存到哪里"**：默认为通用 wiki，可以稍后移动

**"内容零散"**：将相关片段组合成连贯的文档

**"已存在"**：先搜索，如果合适则更新现有内容

**"太非正式"**：在保留见解的同时清理语言

## 示例

有关完整工作流程，请参阅 [examples/](examples/)：
- [examples/conversation-to-faq.md](examples/conversation-to-faq.md) - 从问答创建常见问题
- [examples/decision-capture.md](examples/decision-capture.md) - 决策记录
- [examples/how-to-guide.md](examples/how-to-guide.md) - 从讨论创建操作指南