gemini-summary

Files (7)

• .gitignore
• README.md
• SKILL.md
• githubclaw.json
• package.json
• summarize.js · scripts/
• summarize.js · src/

SKILL.md (first lines)

# 內容摘要 Skill

統一的摘要工具，自動偵測輸入類型（網頁 / PDF / 影片 / 音訊），使用 Gemini Interactions API 產出結構化的繁體中文（zh-TW）Markdown 摘要。

## 需求條件

- **GEMINI_API_KEY**：有效的 Google Gemini API 金鑰（設為環境變數）
- **Node.js** ≥ 20.0.0
- `scripts/summarize.js` 為預先建置的零依賴 bundle，不需 `npm install`

## 支援的輸入類型

| 類型 | 輸入格式 | 使用模型 |
|------|----------|----------|
| 網頁 | `https://example.com/article` | gemini-3-pro-preview |
| PDF | 本地 `./report.pdf` 或遠端 URL | gemini-3-pro-preview |
| 影片 | YouTube URL、影片 URL、本地影片檔、data URI | gemini-3.1-pro-preview |
| 音訊 | 本地音訊檔或遠端 URL | gemini-3-pro-preview |

### 自動偵測邏輯

- `data:` 開頭 → 影片
- HTTP/HTTPS URL：`.pdf` → PDF；影片副檔名或 YouTube 域名 → 影片；音訊副檔名 → 音訊；其他 → 網頁
- 本地檔案：`.pdf` → PDF；影片副檔名 → 影片；音訊副檔名 → 音訊
- 支援的影片格式：`.mp4`, `.mkv`, `.webm`, `.mov`, `.avi`, `.3gp`, `.m4v`, `.mpeg`, `.mpg`, `.ogv`
- 支援的音訊格式：`.mp3`, `.wav`, `.aac`, `.ogg`, `.flac`, `.m4a`, `.aiff`, `.wma`, `.opus`

## 使用方式

直接執行預建好的腳本，不需要先安裝依賴：

> ⚠️ **路徑安全**：skill 腳本位於 **repo 根目錄**的 `.agents/skills/` 下。若 cwd 不在 repo root，請先執行 `git rev-parse --show-toplevel` 取得絕對路徑，再 `cd` 到該路徑後執行。**禁止**在指令中使用 `$(...)` 語法（會被 Copilot CLI 安全過濾器擋下）。

```sh
node .agents/skills/gemini-summary/scripts/summarize.js <input>
```

### 範例

```sh
# 網頁摘要
node .agents/skills/gemini-summary/scripts/summarize.js "https://example.com/posts/agentic-workflows"

# PDF 摘要（本地檔案）
node .agents/skills/gemini-summary/scripts/summarize.js "./reports/quarterly.pdf"

# PDF 摘要（遠端 URL）
node .agents/skills/gemini-summary/scripts/summarize.js "https://example.com/report.pdf"

# 影片摘要（YouTube）
node .agents/skills/gemini-summary/scripts/summarize.js "https://youtu.be/abc123"

# 影片摘要（本地檔案）
node .agents/skills/gemini-summary/scripts/summarize.js "./clips/demo.mp4"

# 音訊摘要（本地檔案）
node .agents/skills/gemini-summary/scripts/summarize.js "./recordings/meeting.mp3"

# 音訊摘要（遠端 URL）
node .agents/skills/gemini-summary/scripts/summarize.js "https://example.com/podcast.mp3"
```

### 手動指定類型

自動偵測通常足夠，但可用 `--type` 覆蓋：

```sh
node .agents/skills/gemini-summary/scripts/summarize.js --type pdf "https://example.com/download?file=report"
node .agents/skills/gemini-summary/scripts/summarize.js --type audio "https://example.com/download?file=recording"
```

### Dry Run

設定 `SUMMARY_DRY_RUN=1` 可在不呼叫 Gemini API 的情況下，預覽輸入偵測結果（JSON 格式）：

```sh
SUMMARY_DRY_RUN=1 node .agents/skills/gemini-summary/scripts/summarize.js "https://youtu.be/abc123"
```

## 輸出格式

輸出為繁體中文 Markdown，包含以下區段：

```markdown
**📝 內容摘要**

**📌 來源**
- 類型：網頁 / PDF文件 / 影片 / 音訊
- 標題：{title}
- 網址：{url}

**💡 核心概述**
{請以流暢的段落整理脈絡，包含：主題背景、關鍵論點與結論}

**🔍 重點條列**
- {重點 1：包含具體的細節、範例或解釋}
- {重點 2：包含具體的細節、範例或解釋}
- ...

**📊 關鍵數據與事實**
（如有關鍵數字、金額、日期或事實才以條列呈現，若無則省略）
- 項目：數值/日期/事實

**🎯 行動建議**
{具體建議或「目前無明確行動建議」}
```

## Instructions for the Agent

⚠️ skill 腳本位於 **repo 根目錄**。若 cwd 不在 repo root，先獨立執行 `git rev-parse --show-toplevel` 取得路徑，再 `cd` 到該路徑後執行。禁止使用 `$(...)` 語法。

1. 確認使用者提供了 URL、PDF 檔案路徑、影片來源、或音訊檔案。
2. 確認環境中已設定 `GEMINI_API_KEY`。
3. 執行指令：
   ```sh
   node .agents/skills/gemini-summary/scripts/summarize.js "<input>"
   ```
4. 腳本會自動偵測輸入類型並選擇適當的處理方式與模型。
5. 結果以串流方式輸出到 stdout，進度與錯誤訊息輸出到 stderr。

From duotify/GitHubClawToolkit, MIT.

More from duotify/GitHubClawToolkit