feishu-deep-research

# Feishu Deep Research

自动执行深度研究并生成飞书文档的完整工作流。

> ⚠️ **重要技术约束**
> 
> 本技能要求 **严格使用飞书 REST API 直接调用**，禁止使用任何封装工具（如 `feishu_doc`、`feishu_drive` 等）。
> 
> **原因**：封装工具隐藏了关键步骤（token获取、文件上传、导入任务），无法验证流程合规性。
> 
> **必须使用**：`exec` 工具 + `curl` 命令直接调用飞书 API

## Usage

```
/feishu-research "研究主题" --folder-token <parent_node>
```

## 执行流程

完整的端到端工作流包含三个阶段：

### Phase 0: 启动确认（唯一交互点）

**必须首先向用户确认：**

```
【启动确认】

研究主题：{topic}
研究深度：{basic/standard/deep}
数据时效：默认覆盖至 {current_date}
搜索速率：默认 1次/秒

请确认或调整：
- 如需指定历史日期范围，请告诉我（例："只需2024年数据"）
- 如需调整搜索速率，请告诉我（例："2次/秒"或"不限"）
- 如无特殊要求，回复"确认"开始执行
```

**规则：**
- 用户无回复 → 等待（不自动开始）
- 用户回复"确认" → 按默认值执行（数据覆盖至current_date，1次/秒）
- 用户指定日期 → 按用户要求的时间范围执行
- 用户指定速率 → 按用户指定的速率执行

### Phase 1: 深度研究（全自动）

确认后**全自动执行**，不再交互。

#### 1.1 前置检查

- **读取当前日期**：确定数据时效目标
- **验证时间范围**：
  - 用户指定日期 → 按用户要求
  - 用户未指定 → 默认覆盖至 current_date
- **验证搜索API可用性**：如不可用，立即停止并报告

#### 1.2 搜索策略（按时间分层）

| 轮次 | 目标 | 时间范围 | 来源要求 |
|------|------|----------|----------|
| 第一轮 | 历史基础数据 | 最近完整财年 | 覆盖核心指标 |
| 第二轮 | 近期表现 | 最近4个季度 | 季度财报/数据 |
| 第三轮 | 最新动态 | 当前年份至current_date | 必须包含当月数据 |

**搜索速率控制：**
- 默认：1次/秒（每次搜索间隔1秒）
- 用户指定：按用户要求执行

**硬性规则：**
- 必须包含当年数据（如今天是2026年，必须有2026年数据）
- 必须覆盖到 current_date - 1个月 以内
- 来源数必须达到深度要求：Basic≥5, Standard≥10, Deep≥20

#### 1.3 数据完整性自动检查

生成报告前自动验证：
```markdown
□ 数据来源数 ≥ 深度要求
□ 数据时间覆盖至目标日期（用户指定或current_date）
□ 包含当年最新数据
□ 至少3种来源类型...