Agent Skills 實戰應用

AI Agent 的 Skill 就像人的技能 -- 騎車、做簡報、談判。Skill 是可重複使用的流程知識，按需載入，用完釋放。

這堂課從 Skill 的運作原理開始，到實際安裝使用，最後用「女媧」這個 Skill 做案例拆解。

Skill 是什麼

沒有 Skill 的 Agent:
  你: 「幫我做 Code Review」
  Agent: 「好的...嗯...我看看這個檔案...」
  → 每次品質不一致，可能漏掉重要檢查項目

有 Skill 的 Agent:
  你: 「幫我做 Code Review」
  Agent: [載入 code-review Skill]
  → Skill 告訴 Agent 要檢查哪些項目、用什麼標準、怎麼寫報告
  → 每次輸出一致、完整

Skill vs Tool

	Tool（工具）	Skill（技能）
本質	能做什麼動作	知道怎麼做事
類比	有一把螺絲起子	知道怎麼修電腦
存在形式	API / 函數	SKILL.md 文字檔
載入方式	永久掛載	按需載入 Context Window
範例	search_web(), read_file()	Code Review SOP、部署流程

SKILL.md 的結構

每個 Skill 就是一份 Markdown 文件，告訴 Agent「遇到這類任務時，照這個流程做」：

一個 Skill 的基本結構:

SKILL.md
├── 觸發條件    什麼時候載入這個 Skill
├── 角色設定    Agent 在這個任務中的角色
├── 流程步驟    一步步怎麼做
├── 品質標準    做到什麼程度算完成
└── 輸出格式    結果長什麼樣子

在哪些工具中使用 Skills

Agent Skills 是一個開放協議，多數 AI Coding 工具都支援：

工具	Skills 目錄	安裝方式
Claude Code	~/.claude/skills/	手動放入或 npx skills add
Codex CLI	~/.codex/skills/	手動放入或 npx skills add
Cursor	~/.cursor/skills/	手動放入或 npx skills add
OpenCode	~/.opencode/skills/	手動放入
Gemini CLI	對應目錄	npx skills add

通用安裝指令（自動偵測目前使用的工具）：

npx skills add 作者/skill名稱

指定工具安裝：

npx skills add 作者/skill名稱 -a claude-code
npx skills add 作者/skill名稱 -a cursor
npx skills add 作者/skill名稱 -a codex

實際範例：常見 Skill 用途

Skill	用途	怎麼觸發
Code Review	系統性檢查程式碼品質	「幫我 review 這個 PR」
部署流程	標準化部署步驟	「部署到 production」
安全掃描	檢查常見安全漏洞	「掃描這個專案的安全問題」
文件撰寫	統一文件格式和風格	「幫這個 API 寫文件」
Bug 分析	系統性 debug 流程	「這個 bug 的根因是什麼」

案例研究：女媧（Nuwa Skill）

女媧是一個「蒸餾思維」的 Skill。輸入一個人的名字，它會自動調研、提煉出那個人的思考模式，生成一個可運行的「視角 Skill」。

輸入: 「蒸餾查理芒格的思維」

女媧的六路調研:
┌─────────────────────────────────────────────────────┐
│  Agent 1: 著作     書、論文、長文 → 核心論點         │
│  Agent 2: 對話     訪談、AMA → 即興反應、類比方式    │
│  Agent 3: 表達     Twitter、短文 → 用詞句式、立場    │
│  Agent 4: 他者     書評、批評、傳記 → 外部觀察       │
│  Agent 5: 決策     重大決策、轉折點 → 決策框架       │
│  Agent 6: 時間線   出生到現在 → 思想轉變             │
└─────────────────────────────────────────────────────┘
           ↓ 三重驗證（交叉比對、事實查核、盲測）
           ↓
輸出: munger.skill
  ├── 心智模型（多元思維模型、逆向思考）
  ├── 決策啟發式（能力圈、安全邊際）
  └── 表達風格（直接、辛辣、引用歷史）

之後你可以:
「用芒格的視角分析這個投資決策」
「芒格會怎麼評價這個商業模式？」

安裝女媧

npx skills add alchaincyf/nuwa-skill -a claude-code

安裝後在 Claude Code 中直接說「蒸餾費曼的思維」，女媧就會開始工作。

已蒸餾的人物

人物	領域	安裝指令
Paul Graham	創業、寫作	npx skills add alchaincyf/paul-graham-skill
馬斯克	工程、第一性原理	npx skills add alchaincyf/elon-musk-skill
芒格	投資、多元思維	npx skills add alchaincyf/munger-skill
費曼	物理、教學	npx skills add alchaincyf/feynman-skill
Naval	財富、槓桿	npx skills add alchaincyf/naval-skill

女媧背後的技術

女媧展示了 Skill 的進階用法 -- 一個 Skill 可以產生其他 Skill：

一般 Skill:
  輸入 → 執行任務 → 輸出結果

女媧:
  輸入人名 → 六路調研 → 三重驗證 → 輸出一個新的 Skill
  ↑ Skill 會生成 Skill（meta-skill）

自己寫一個 Skill

寫 Skill 不需要會寫程式。一個 SKILL.md 範例：

# Code Review Skill

觸發條件: 當使用者要求 review 程式碼時載入此 Skill

## 角色
你是資深工程師，負責系統性的程式碼審查。

## 流程
1. 先讀懂整個變更的目的（看 PR description 或 commit message）
2. 檢查以下項目:
   - 邏輯正確性: 程式做的事跟預期一致嗎？
   - 安全性: 有 SQL Injection、XSS、硬編碼密鑰嗎？
   - 效能: 有不必要的迴圈、N+1 查詢嗎？
   - 可讀性: 命名清楚嗎？邏輯好理解嗎？
   - 測試: 有對應的測試嗎？涵蓋邊界情況嗎？
3. 對每個問題標注嚴重性（Critical / Warning / Suggestion）
4. 給出整體評分（通過 / 需修改 / 不通過）

## 輸出格式
用 Markdown 表格列出所有發現，附上檔案路徑和行號。

把這個檔案放到 ~/.claude/skills/code-review/SKILL.md，Agent 就會在需要時載入使用。

作業

作業 1：安裝並使用女媧

1. 在 Cursor、Claude Code 或 Antigravity CLI 中安裝女媧 Skill
2. 蒸餾一個你感興趣的人物（例如：費曼、賈伯斯）
3. 用蒸餾出來的視角 Skill 分析一個你正在面對的問題
4. 截圖記錄蒸餾過程和分析結果

npx skills add alchaincyf/nuwa-skill -a claude-code

作業 2：寫你自己的 Skill

針對你日常工作中的一個重複性任務，寫一個 SKILL.md：

1. 定義觸發條件
2. 寫出完整的執行步驟
3. 設定品質標準和輸出格式
4. 把它放到你的 Agent 的 skills 目錄中測試