feishu-analyst

Feishu Document Analyst

Analyze Feishu documents efficiently with zero-context MCP calling.

Zero-Context MCP 调用

本 Skill 使用 零上下文模式 调用飞书 MCP 工具：

• 工具定义不加载到 context（节省 ~15,000 tokens）
• 工具响应不注入 context（执行时 0 tokens）
• 通过 executor.py 外部执行

Prerequisites

依赖已内置，只需确保：

• Python 3.8+
• mcp package 已安装：pip install mcp

首次使用配置

方式一：运行配置脚本（推荐）

python scripts/setup.py

方式二：设置环境变量

export FEISHU_APP_ID='your-app-id'
export FEISHU_APP_SECRET='your-app-secret'
export FEISHU_AUTH_TYPE='tenant'  # 或 'user'

获取凭证：https://open.feishu.cn/ → 创建应用 → 凭证与基础信息

Quick Start

For PRD Analysis (Recommended)

Use the dedicated slash command: /feishu-prd-analyse <URL>

Example:

/feishu-prd-analyse https://dy3m1s1v7v.feishu.cn/docx/CgMCdRMh8oMtDKxVcURcrb0DnVr

This command will automatically:

1. Read the ENTIRE document (all text, tables, whiteboards, images, diagrams, flowcharts, etc.)
2. Use zero-context MCP calling via executor.py
3. Load the PRD checklist from references/prd_checklist.md
4. Extract document content and convert to Markdown
5. Apply systematic analysis framework
6. Generate structured review with findings and recommendations

Manual Analysis

入口选择指南

场景	入口	说明
固定流程（PRD 分析）	/feishu-prd-analyse	稳定、可预测
动态需求	Python API	灵活、可组合
命令行操作	CLI	直接调用

1. CLI 命令

# 获取文档并保存到临时文件
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" save "https://xxx.feishu.cn/wiki/xxx"

# 输出示例：
# {
#   "document_id": "G85TdPCcTo91CYx4aYzcLKCnnFe",
#   "title": "文档标题",
#   "blocks_file": "/tmp/document_G85TdPCcTo91CYx4aYzcLKCnnFe_blocks.json",
#   "markdown_file": "/tmp/document_G85TdPCcTo91CYx4aYzcLKCnnFe.md"
# }

# 指定输出目录
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" save "https://xxx.feishu.cn/wiki/xxx" --output-dir ./output

# 获取文档大纲
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" outline /tmp/document_xxx_blocks.json

# 列出所有工具
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" list

# 获取工具描述
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" describe get_feishu_document_blocks

# 直接调用工具
python "${CLAUDE_PLUGIN_ROOT}/skills/feishu-analyst/scripts/cli.py" call get_feishu_document_info \
  --args '{"documentId": "https://xxx.feishu.cn/wiki/xxx", "documentType": "wiki"}'