AGENT SKILL 一日工作坊 · 階梯 3

貼上連結,它自己下載、自己分類

IG 影片下載不只是一行指令。今天你要做出一個三層俱全的 Skill:AI 負責判斷類別,腳本負責粗活,素材庫自動長出來。

⏱ 約 30 分鐘 8 頁 · 由淺入深 三層 Skill · 完整打通
這堂的三步走:通用最小範例(先下一支)→ 做成三層 Skill(自動分類)→ 卡關備援 + 下午的延伸鉤子。

這堂你會得到什麼

貼連結就跑,跑完自己歸位

學習目標

做出一個貼上 IG 連結就自動下載、還會自己語意分類歸檔的 Skill。親眼看到 Skill 不只是文字 SOP,還能裝腳本、能自己做判斷。

你帶走的東西

一個完整的 ig-reel-downloader Skill,以及「三層 Skill 長什麼樣」的具體手感。

為什麼用 IG 當例子?做社群、蒐集競品素材的人,這就是一個自動歸檔素材庫。同樣這套手法,套到任何「下載 + 分類」的工作都行。

通用最小範例

先讓它下一支,看它怎麼動

不分類、不歸檔。就是把一支公開 Reel 下載到你桌面的 ig 資料夾。

# 貼給 Claude Code 的指令
我貼一個 Instagram Reel 連結給你。
用 yt-dlp 幫我把這支影片下載到桌面的 ig 資料夾,
檔名用影片 id(避免標題的 emoji 或符號造成存檔失敗)。

# 然後把你的 IG Reel 連結貼在下面
https://www.instagram.com/reel/XXXXX
教學重點:AI 自己不會下載。是它呼叫 yt-dlp 這個工具去抓。這就是先備知識說的「Tool 是 AI 的手」,你現在親眼看到了。

AI 在背後做了什麼

一個指令,背後有這幾步

1
解析你的指令,理解「要下載到桌面 ig 資料夾、用影片 id 當檔名」
2
確認 ig 資料夾存在,不存在就自動建立
3
呼叫 yt-dlp,傳入連結 + 輸出路徑 + 檔名格式
4
yt-dlp 連到 IG,抓影片串流,存到你的桌面
影片出現在桌面。你只打了一行字,它跑了這四步。
這就是 Agent 跟一般 AI 聊天的差別:它不只是「說說而已」,它會規劃步驟呼叫工具真的執行。你下一步要做的三層 Skill,就是把這個能力封裝起來,讓它每次都照這個流程走。

三明治三層

SOP 教方法、references 放規則、
scripts 真正動手

📋
SKILL.md
下載與分類的完整 SOP。AI 讀這裡知道要做哪幾步、順序是什麼。
第 1 層
📚
references/category_rules.md
分類判定規則。美食、旅遊、知識、生活、迷因各自的定義。AI 查這裡做決定。
第 2 層
⚙️
scripts/ ensure_dirs.sh · fetch.sh
真正動手的腳本。ensure_dirs.sh 建目錄,fetch.sh 下載影片。粗活給腳本。
第 3 層
分工邏輯:AI 負責「聰明的那一塊」(讀 SOP、查規則、決定類別),腳本負責「機械的那一塊」(建目錄、抓影片)。AI 不用記住怎麼下載,腳本不用思考類別是什麼。這套分工讓整個 Skill 既穩定又容易維護。

你說這個,它做出那個

叫它做成 Skill,它就把三層都生出來

# 貼給 Claude Code,讓它做 Skill
幫我把這個流程做成一個 skill,叫 ig-reel-downloader。
流程是:① 確保分類資料夾存在 ② 抓影片標題和說明
③ 根據內容判斷類別(美食、旅遊、知識、生活、迷因)
④ 下載到對應的分類資料夾
description 要寫成:貼上 instagram.com/reel 連結、或說
「下載 IG」時觸發。

它幫你生出來的

SKILL.md:完整 SOP
references/category_rules.md
scripts/ensure_dirs.sh
scripts/fetch.sh

你只做一件事

貼連結進去。Skill 自動跑完四步,影片出現在對應分類資料夾裡。不用每次手動判斷「這支是美食還是旅遊」。

遇到問題怎麼辦

IG 抓取本來就不穩,我們有備案

yt-dlp 沒裝

課前 checklist 有提醒。現場補裝:Mac 跑 brew install yt-dlp,Windows 跑 pip install yt-dlp,一分鐘內裝好。

影片抓不到(私人帳號 / IG 擋下)

換一支公開 Reel 試試。真的全都抓不到?用課前發的 sample_ig_metadata.json,照樣跑「判斷類別 + 歸檔」這段。分類那一招你一樣學到了,這才是重點。

被限流(429)/ 檔名存檔失敗

限流:間隔幾秒再試,別連續猛抓。檔名有 emoji 或斜線?請 Claude 改用影片 id 當檔名,問題自動消失。

這堂的收穫

三層 Skill 的手感,下午還要再用一次

全員帶走

做出「下載 + 自動分類」的完整 Skill。抓到影片就分類,抓不到就用 sample 跑分類那一招。重點是學會三層結構,而不是那支影片。

技術端進階

references/category_rules.md 的分類規則寫細,加更多類別,讓分類更準確。同一套 Skill,規則越細越聰明。

下午的鉤子(現在先埋著):這個下載歸檔,下午我們會讓它再往前一步。不只存本機,還能直接傳上 Google Drive 對應的雲端資料夾、再貼一則連結到團隊 Slack:「競品又出新片了,我存好了」。到時候你會發現,串 Drive、串 Slack,跟你下午串 serper 是一模一樣的招