feishu-folder-summary

# Feishu Folder Summary

This skill extracts summaries from all documents in a Feishu folder (wiki or drive), recursively scanning sub-folders and generating a comprehensive Markdown report.

## Overview

The skill performs the following operations:
1. Parses the Feishu folder URL to extract space_id and node_token
2. Recursively traverses the folder structure using feishu_wiki API
3. Reads each document's content using feishu_doc API
4. Generates structured summaries for each document
5. Compiles a comprehensive Markdown report with:
   - Complete directory tree
   - Document summaries organized by folder
   - Statistics and status overview
   - Links to original documents

## Supported URL Formats

- **Wiki folders**: `https://{domain}.feishu.cn/wiki/{node_token}`
- **Drive folders**: `https://{domain}.feishu.cn/drive/folder/{folder_token}`

## Workflow

### Step 1: Extract Folder Information

Parse the provided Feishu URL to identify:
- Document type (wiki or drive)
- Space ID (for wiki)
- Node token or folder token

### Step 2: Recursive Traversal

Use `feishu_wiki` API to traverse the folder structure:

```
feishu_wiki action="get" token="{node_token}"         # Get folder info
feishu_wiki action="nodes" space_id="{space_id}"      # List child nodes
```

For folders with `has_child: true`, recursively process child nodes.

### Step 3: Document Reading

For each document node, read its content:

```
feishu_doc action="read" doc_token="{obj_token}"
```

### Step 4: Generate Summary

Extract from each document:
- **Title**: Document title
- **Type**: Document or Folder
- **Status**: Complete, In Progress, or Empty
- **Core Content**: Key points, main topics, important information
- **Child Documents**: If folder, list contained documents

### Step 5: Compile Report

Generate a Markdown report with:
1. Header (source URL, generation time, document count)
2. Directory tree visualization
3. Hierarchical summaries (by folder level)
4. Statistics table
5. Related links...