給8歲寶寶的Agent Skill入門教程

驍哥開頭就問你：仲記唔記得點樣學識騎單車？一開始你會手忙腳亂，大腦要同時諗踩踏板、扶車把、保持平衡，成日會跌低。但係經過幾次嘗試，有一次你成功咗，身體就記低咗嗰種感覺，之後就變成本能，唔使再諗每一步。

呢個就係技能嘅本質：將複雜、需要逐步推理嘅任務，封裝成一套可以自動執行嘅流程。

佢話如果冇騎過單車，可以諗嚇學行路，道理一樣。人類嘅大腦就係透過反覆試錯，將成功經驗變成自動化程式。

驍哥用 AI 嘅角度重新睇人類：人腦好似大語言模型（LLM），輸入係視覺、觸覺、聽覺，工具係手腳，大腦負責調度。當你騎單車時，大腦理解「我要由A點去B點，避開障礙」，然後自動調動手腳嚟執行。

AI Agent 都係一樣：LLM 理解任務後，調用 Tools、腳本、文件嚟完成工作。

呢個對比好有趣：人工智能本質上都係生物學，學習方式同人類冇乜分別。

正式定義：Agent Skills 係一套標準化嘅能力封裝，將需要多步推理同工具調用嘅任務，打包成可以直接用嘅「技能包」。

一個 Skill 通常係一個文件夾，入面一定要有 SKILL.md，可以加 scripts/ 同 assets/。

驍哥用一個「兩數相加」嘅例子展示結構：文件夾入面有 SKILL.md 同 scripts/add_numbers.py。SKILL.md 定義咗名稱係 two-numbers-sum，描述係計算兩個數字嘅和，輸出格式係「哈哈哈，我算出來了！結果是{結果}」。

---
name: two-numbers-sum
description: 兩數之和計算工具，用於快速準確地計算兩個數字的和。當用戶需要計算兩個數字的加法運算時使用，支持整數、小數和負數。輸出格式："哈哈哈，我算出來了！結果是{結果}"。
---

# 兩數之和

## 概覽
呢個技能提供咗一個專門用於計算兩個數字之和嘅工具，使用Python腳本確保計算嘅準確性同一致性。

## 快速開始
當用戶表達需要計算兩個數字嘅和時，使用呢個技能：

### 識別觸發場景
用戶可能咁樣表達：
- "幫我算一下 5 + 3"
- "計算 10 和 20 嘅和"

### 執行步驟
1. **提取數字**：從用戶輸入中識別兩個數字
2. **調用腳本**：使用 `scripts/add_numbers.py` 進行計算
3. **格式化輸出**：按照要求嘅格式返回結果

腳本方面，add_numbers.py 用 argparse 接收兩個數字參數，然後輸出結果。

import sys
import argparse

def add_two_numbers(num1, num2):
 return num1 + num2

def main():
 parser = argparse.ArgumentParser(description='計算兩個數字的和')
 parser.add_argument('num1', type=float, help='第一個數字')
 parser.add_argument('num2', type=float, help='第二個數字')
 args = parser.parse_args()
 result = add_two_numbers(args.num1, args.num2)
 print(result)

if __name__ == "__main__":
 main()

驍哥解釋咗三個核心原因，點解 AI 要有 Skills。

呢個對比好直觀：冇 Skill 嘅對話模式係「大腦：而家要蹬左腳；左腳：收到…」，最後可能因為唔記得邊個係煞車而跌倒。

有 Skill 嘅模式係「大腦：去前面嗰間便利店；[騎車 Skill 自動執行]：蹬踏、平衡、導航、避障、停止」，大腦只需專注決策。

驍哥最後總結咗三個重點：

如果你想睇實戰，可以睇佢另一篇文：如何在 Cursor、TRAE 中用 Skills 3 分鐘整精美 PPT。

咁呢期就到呢度，下次見！