workspace-documentation

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: workspace-documentation
description: Capture and organize knowledge in workspace platforms. Structures information into wikis, databases, and connected knowledge graphs.
license: Proprietary. LICENSE.txt has complete terms
---

# Knowledge Capture

Transforms conversations, discussions, and insights into structured documentation in your Notion workspace. Captures knowledge from chat context, formats it appropriately, and saves it to the right location with proper organization and linking.

## Quick Start

When asked to save information to Notion:

1. **Extract content**: Identify key information from conversation context
2. **Structure information**: Organize into appropriate documentation format
3. **Determine location**: Use `Notion:notion-search` to find appropriate wiki page/database
4. **Create page**: Use `Notion:notion-create-pages` to save content
5. **Make discoverable**: Link from relevant hub pages, add to databases, or update wiki navigation so others can find it

## Knowledge Capture Workflow

### Step 1: Identify content to capture

```
From conversation context, extract:
- Key concepts and definitions
- Decisions made and rationale
- How-to information and procedures
- Important insights or learnings
- Q&A pairs
- Examples and use cases
```

### Step 2: Determine content type

```
Classify the knowledge:
- Concept/Definition
- How-to Guide
- Decision Record
- FAQ Entry
- Meeting Summary
- Learning/Post-mortem
- Reference Documentation
```

### Step 3: Structure the content

```
Format appropriately based on content type:
- Use templates for consistency
- Add clear headings and sections
- Include examples where helpful
- Add relevant metadata
- Link to related pages
```

### Step 4: Determine destination

```
Where to save:
- Wiki page (general knowledge base)
- Specific project page (project-specific knowledge)
- Documentation database (structured docs)
- FAQ database (questions and answers)
- Decision log (architecture/product decisions)
- Team wiki (team-specific knowledge)
```

### Step 5: Create the page

```
Use Notion:notion-create-pages:
- Set appropriate title
- Use structured content from template
- Set properties if in database
- Add tags/categories
- Link to related pages
```

### Step 6: Make content discoverable

```
Link the new page so others can find it:

1. Update hub/index pages:
   - Add link to wiki table of contents page
   - Add link from relevant project page
   - Add link from category/topic page (e.g., "Engineering Docs")

2. If page is in a database:
   - Set appropriate tags/categories
   - Set status (e.g., "Published")
   - Add to relevant views

3. Optionally update parent page:
   - If saved under a project, add to project's "Documentation" section
   - If in team wiki, ensure it's linked from team homepage

Example:
Notion:notion-update-page
page_id: "team-wiki-homepage-id"
command: "insert_content_after"
selection_with_ellipsis: "## How-To Guides..."
new_str: "- <mention-page url='...'>How to Deploy to Production</mention-page>"
```

This step ensures the knowledge doesn't become "orphaned" - it's properly connected to your workspace's navigation structure.

## Content Types

Choose appropriate structure based on content:

**Concept**: Overview → Definition → Characteristics → Examples → Use Cases → Related
**How-To**: Overview → Prerequisites → Steps (numbered) → Verification → Troubleshooting → Related
**Decision**: Context → Decision → Rationale → Options Considered → Consequences → Implementation
**FAQ**: Short Answer → Detailed Explanation → Examples → When to Use → Related Questions
**Learning**: What Happened → What Went Well → What Didn't → Root Causes → Learnings → Actions

## Destination Patterns

**General Wiki**: Standalone page → add to index → tag → link from related pages

**Project Wiki**: Child of project page → link from project overview → tag with project name

**Documentation Database**: Use properties (Title, Type, Category, Tags, Last Updated, Owne