Agent Skill vs. SpecCoding

影片製作腳本 | Video Production Script

核心比喻：你的 AI 開發環境就是一間「頂級餐廳」

「AI 不是不懂程式，而是你沒告訴它『你要什麼樣的工程師』。」

0:00 – 0:50

畫面 Visual

場景：廚房裡的災難

一個看起來很厲害的機器人廚師（LLM），面對一堆食材手忙腳亂。
你對它喊：「做個漢堡！」
結果它做出來一個把肉放在麵包外面的奇怪物體，或者加了巧克力醬的漢堡。
特效字卡：「AI 不是不懂程式，而是你沒告訴它『你要什麼樣的工程師』。」

旁白 Narration

「你是否覺得你的 AI 寫 Code 總是『有做沒有懂』？明明能跑，但寫法完全不符合你們團隊的規範？」

「問題不在 AI 笨，而在於你把它當成一個路人，直接叫它做菜。」

「今天我們用『頂級餐廳』的概念，徹底搞懂 Agent Skill 和 SpecCoding。」

0:50 – 2:00

畫面 Visual

Part 1: Agent Skill —— 主廚的「流派與紀律」

Skill = 主廚的訓練 (The Context / The Persona)

給原本裸體的機器人穿上潔白的廚師服，戴上高帽。
帽子上寫著「米其林三星標準」或「嚴格衛生規範」。

旁白 Narration

「Agent Skill 就像是廚師的『職前訓練』。」

「它定義了這位廚師的流派：是做法式料理（Python/Django）？還是日式板前（Go/Microservices）？」

「它也定義了『廚房紀律』：刀子用完要歸位（變數命名規則）、抹布不能亂丟（Error Handling 規範）。」

「這些規則是 永久的，不管今天煮什麼菜，都要遵守。」

2:00 – 3:10

畫面 Visual

Part 2: SpecCoding —— 客人的「點餐單」

Spec = 當下的訂單 (The Instruction / The Task)

服務生遞進來一張單子（Markdown 文件）。
上面寫著：「A 桌客人：三分熟牛排、不要洋蔥、醬汁分開放。」

旁白 Narration

「有了好廚師（Skill），他還是不知道現在要做什麼。這時候你需要 SpecCoding。」

「Spec 就是這張『點餐單』。它告訴主廚：『現在我要一個登入功能（牛排）』，『密碼要加密（三分熟）』。」

「這張單子是 一次性的，做完這道菜，這張單子就結案了。」

3:10 – 4:10

畫面 Visual

Part 3: 流程解密（為什麼順序很重要？）

                            LLM (素人)

                            穿上 Skill (變主廚)

                            接到 Spec (看訂單)

                            Code (上菜)

旁白 Narration

「很多人搞錯順序，以為可以直接丟 Spec 給 LLM。錯了！」

「想像一下，你給一個路人（LLM）一張點菜單，他看得懂字，但他沒有受過訓練，做出來的菜能吃嗎？」

「正確流程是： 先載入 Skill （確認他是你們團隊的一員）， 再給 Spec （告訴他任務）。」

4:10 – 5:20

畫面 Visual

Part 4: 錯誤示範（為什麼不能混淆？）

情境 A：把「點餐內容」寫在「廚師訓練手冊」裡

畫面：廚師的訓練手冊裡寫著條款：「每道菜都要加香菜」。結果客人點草莓蛋糕，廚師也加了香菜。

情境 B：把「衛生規範」寫在「點餐單」上

畫面：客人點餐時，要在單子上寫：「我要牛排，還有請記得洗手、請記得戴帽子…」客人崩潰。

旁白 Narration

「把業務邏輯（Spec）寫進 Skill，就像強迫廚師不管煮什麼都要加香菜，這會毀了你的專案。」

「把通用規範（Skill）寫進 Spec，你每次開發新功能都要重複寫一堆廢話，效率極低。」

5:20 – 6:00

畫面 Visual

結尾與彩蛋 (Pro Tip)

展示：.cursorrules (Skill) 和 spec.md (Spec) 的真實樣子。

旁白 Narration

「總結：Skill 負責『怎麼做』(How)，Spec 負責『做什麼』(What)。」

「最後給個小撇步：頂級餐廳都有『試菜』環節。」

「在讓 AI 寫完整個 App 之前，先叫它『備料』(Generate Plan)。讓它先解釋它打算怎麼做，確認沒問題再開火。」

製作建議 Highlights

視覺對比

左邊放一盤「路邊攤亂炒」（沒有 Skill 的 Code）。右邊放一盤「精緻擺盤料理」（加了 Skill 的 Code）。用紅筆圈出差異（例如：註解、Docstring）。

音效運用

講到 Skill 時，用清脆的「磨刀聲」或「廚房整隊聲」（代表紀律）。講到 Spec 時，用「打印機印出單據」的聲音（代表任務來了）。

真實檔案展示

不要只講概念，畫面要閃過 .cursorrules 和 spec.md 的真實樣子，讓觀眾知道這不僅僅是比喻，而是可以落地的技術。