Initial commit with translated description

This commit is contained in:
2026-03-29 08:23:37 +08:00
commit 5ff72aabdb
3 changed files with 251 additions and 0 deletions

69
SKILL.md Normal file
View File

@@ -0,0 +1,69 @@
---
name: gemini-deep-research
description: "使用Gemini深度研究代理执行复杂、长期的研究任务。在被要求研究需要多源综合、竞争分析、市场调研或全面技术调查的主题时使用这些主题受益于系统的网络搜索和分析。"
metadata: {"clawdbot":{"emoji":"🔬","requires":{"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY"}}
---
# Gemini Deep Research
Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks.
## Prerequisites
- `GEMINI_API_KEY` environment variable (from Google AI Studio)
- **Note**: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key.
## How It Works
Deep Research is an agent that:
1. Breaks down complex queries into sub-questions
2. Searches the web systematically
3. Synthesizes findings into comprehensive reports
4. Provides streaming progress updates
## Usage
### Basic Research
```bash
scripts/deep_research.py --query "Research the history of Google TPUs"
```
### Custom Output Format
```bash
scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \
--format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks"
```
### With File Search (optional)
```bash
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
--file-search-store "fileSearchStores/my-store-name"
```
### Stream Progress
```bash
scripts/deep_research.py --query "Your research topic" --stream
```
## Output
The script saves results to timestamped files:
- `deep-research-YYYY-MM-DD-HH-MM-SS.md` - Final report in markdown
- `deep-research-YYYY-MM-DD-HH-MM-SS.json` - Full interaction metadata
## API Details
- **Endpoint**: `https://generativelanguage.googleapis.com/v1beta/interactions`
- **Agent**: `deep-research-pro-preview-12-2025`
- **Auth**: `x-goog-api-key` header (NOT OAuth Bearer token)
## Limitations
- Requires Gemini API key (get from [Google AI Studio](https://aistudio.google.com/apikey))
- Does NOT work with Antigravity OAuth authentication
- Long-running tasks (minutes to hours depending on complexity)
- May incur API costs depending on your quota