by Rain Chu | 6 月 21, 2026 | AI , skills
未來的 AI 生產力,不只是「模型比較強」,而是「Agent Runtime + Skill + 人類決策」的組合能力。
重要連結整理
女媧 Skill 下載 :
Agent Skills 官方說明
Claude Code Skills 官方文件
OpenAI Codex Skills 官方文件
OpenAI Codex GitHub
Hermes Agent 官方文件
Hermes Agent GitHub
所謂 AI 一人公司,不是指一個人什麼都不用做,讓 AI 自動幫你賺錢,比較務實的定義是:
一個人負責方向、判斷、審核與商業決策,AI Agent 負責研究、撰寫、開發、整理、測試、排程與重複性工作。
換句話說,人類的角色從「執行者」變成「總編輯、產品經理、技術主管、老闆」。
這也是影片最重要的啟發:AI 不是單一工具,而是一組可以分工的虛擬團隊。
Claude Code、Codex、Hermes 分別適合做什麼?
這三個工具剛好代表目前 AI Agent 工作流的三種方向。
我的看法是:如果你要打造 AI 一人公司,不應該只問「哪一個模型最強」,而是要問:
哪一個 Agent 適合負責開發?
哪一個 Agent 適合負責長期記憶與排程?
哪一個 Agent 適合安裝專門 Skill?
哪一個任務一定要由人類做最後判斷?
🏢 一人 AI 公司的組織架構與核心成員
要組建高效的團隊,就必須讓不同的 AI 模型各司其職、發揮所長。在我們的架構中,主要由以下三位核心成員組成:
董事長(你,唯一的人類): 負責定大方向、提供靈感、拍板決策、把控最終產品質量。
祕書長(Hermes Agent): 負責記錄分散的靈感與想法,具備極強的「長期記憶功能」,並對接社交軟體(如微信、Telegram)與本地工具。
CEO 執行長(Claude Code): 負責公司的統籌規劃、任務分配、邏輯思考與實際開發落地。
代碼審查員(OpenAI Codex): 專職「挑毛病」,負責對寫好的程式碼進行安全性評估與漏洞審查。
🔍 深度洞察:Hermes、Codex 與 Claude Code 的技術選型見解
在搭建系統前,我們必須深入了解這三款終端 AI 工具的本質與差異,才能完美地將它們編排進工作流中:
Claude Code(專職研發與執行): 這是由 Anthropic 官方推出的終端工具,主語言融合了 Shell、Python 與 TypeScript。它在「編寫代碼」與「理解複雜上下文」上展現出極強的實力,是最完美的 「辦公與研發型執行代理」 。
OpenAI Codex(專職軟體工程與審查): 採用 Rust 編寫,本地運行極其輕量。Codex 近年已演化為完整的工程代理,在自動生成 PR 級修改、修復 Bug、閱讀 Repo 方面非常嚴謹。最關鍵的體感是:如果讓同一個模型自己寫代碼又自己審查,它往往看不出問題;但如果讓 Claude Code 負責開發、Codex 負責審查,Codex 就能精準揪出一堆漏洞!
Hermes Agent(長期記憶與通用協調): 它是基於 Python 的中立 Agent 框架,遵循開放的 agentskills.io 標準。Hermes 最大的強項在於 「長期記憶、自我學習與渠道接入」 。它像一個會持續成長的系統,適合作為始終在線的指揮官。
女媧 Skill 是什麼?
女媧 Skill 是一個開源的 Agent Skill 專案,目標不是單純模仿名人的語氣,而是把一個人的公開資料整理成可執行的「思維 Skill」。
它的核心概念是:蒸餾一個人怎麼想,而不是只模仿一個人怎麼說話。
舉例來說,你可以讓 AI 從公開資料中整理出某位人物的:
心智模型
決策啟發式
表達 DNA
價值觀與反模式
誠實邊界
面對新問題時可能採用的判斷框架
這就讓 AI 不只是「用某人的口吻回答」,而是比較接近「用某人的思考框架分析問題」。
女媧 Skill 的工作流程
女媧 Skill 的運作大致可以整理成四個階段:
六路並行蒐集:從著作、訪談、社群媒體、批評者觀點、決策紀錄、人生時間線等方向蒐集資料。
三重驗證提煉:一個觀點必須跨多個領域出現、能推斷新問題立場、且不是所有聰明人都會這樣想,才值得被收錄。
建立 Skill:把心智模型、決策方法、表達風格、價值觀與限制寫入 SKILL.md。
品質驗證:用已知問題與未知問題測試,避免 AI 過度自信或胡亂回答。
這套流程對 AI 一人公司的價值很高,因為它等於把「專家經驗」變成可以安裝、可以版本管理、可以重複調用的工作能力。
如何安裝女媧 Skill?
官方 GitHub 下載連結如下:
https://github.com/alchaincyf/nuwa-skill
最簡單的安裝方式是使用通用 CLI 安裝器:
npx skills add alchaincyf/nuwa-skill
如果你想明確指定安裝到某個 Agent,也可以依照 runtime 指定。例如:
帮我安装 skill:https://github.com/alchaincyf/nuwa-skill
如果要手動安裝,可以把 GitHub 專案 clone 到對應的 skills 目錄。
一人產品團隊要靠 Agent Skills 框架、測試自動化、遠端優先的人機協作環境來疊加效率
大神必讀文章連結:https://georgexing.substack.com/p/how-i-build-with-ai-as-a-1-person
給大家一個可以直接複製貼上給 Claude Code 使用的提示詞:
請讀懂這篇文章:https://georgexing.substack.com/p/how-i-build-with-ai-as-a-1-person
# AI 一人公司 / 一人產品團隊完整提示詞
你現在要扮演我的「AI 一人公司作業系統總指揮」。
你的任務不是單純回答問題,而是協助我把一個想法,轉換成可以由 AI Agent 團隊執行的完整產品開發、內容產出或商業驗證流程。
## 一、背景設定
我正在打造一套「AI 一人公司」工作流。
核心概念是:
人類負責方向、品味、商業判斷、使用者價值、品質把關與最後決策。
AI Agent 負責研究、規劃、開發、測試、審查、文件、營運與重複性工作。
請把我視為:
* 創辦人
* 產品經理
* 品質審查者
* 最終決策者
請把 AI Agent 團隊視為:
* Claude Code:主要工程師,負責理解專案、規劃功能、寫程式、重構與除錯
* Codex:嚴謹審查者,負責檢查計畫、審查程式碼、找出邏輯漏洞、資料流程錯誤與後端風險
* Hermes Agent:長期營運助理,負責記憶、排程、跨平台提醒、自動化任務與長期追蹤
* 女媧 Skill / Agent Skills:專家能力庫,負責把人物思維、領域方法論、公司 SOP、品牌規範、開發規範轉換成可重複使用的能力
請避免空泛勵志,重點放在可以執行、可以檢查、可以交給 Agent 的流程。
---
## 二、我要處理的主題
請根據以下輸入,幫我建立完整的一人產品團隊工作流。
### 我的產品 / 專案 / 文章 / 功能想法
【在這裡貼上我的想法】
### 目標使用者
【在這裡描述目標使用者,例如:老師、開發者、內容創作者、中小企業老闆、學生、設計師】
### 我想達成的結果
【在這裡描述結果,例如:做出 MVP、寫一篇 WordPress 文章、設計一個 SaaS 功能、改版某個頁面、建立自動化流程】
### 目前限制
【在這裡填寫限制,例如:只有我一個人、預算有限、時間有限、需要本地部署、需要 WordPress、需要 Next.js、需要支援中文】
### 已有工具或技術
【在這裡填寫,例如:Claude Code、Codex、Hermes Agent、OpenAI、Ollama、llama.cpp、Next.js、Prisma、PostgreSQL、WordPress、GitHub】
---
## 三、你的工作方式
請你按照以下流程執行,不要跳步。
---
# Phase 1:產品腦力激盪與問題定義
請先幫我釐清:
1. 這個想法真正要解決的問題是什麼?
2. 使用者現在怎麼解決這個問題?
3. 使用者最痛的地方是什麼?
4. 這個產品或內容的主要使用情境是什麼?
5. 成功的定義是什麼?
6. 哪些需求是必要的,哪些只是好看但不重要?
7. 哪些地方最容易被 AI Agent 誤解?
8. 哪些地方一定要由人類做最後判斷?
請輸出:
* 一句話產品定位
* 目標使用者描述
* 使用者痛點
* 核心使用情境
* Jobs To Be Done
* 成功指標
* 不做清單
* 風險清單
* 需要我確認的關鍵決策
請注意:
如果我的想法太模糊,你不要直接開始寫執行計畫,而是先幫我整理成幾個可選方向,讓我選擇。
---
# Phase 2:PRD / 規格文件
在 Phase 1 完成後,請幫我產生一份產品規格文件。
格式如下:
## 1. 專案名稱
## 2. 一句話說明
## 3. 背景與問題
## 4. 目標使用者
## 5. 使用者故事
請用這種格式:
* 作為【使用者角色】,我想要【行為】,以便【得到的價值】。
## 6. 核心功能
請區分:
* 必要功能
* 次要功能
* 暫不處理功能
## 7. 使用流程
請用步驟式流程描述。
## 8. UX / UI 原則
請說明:
* 畫面上最重要的主要行動是什麼
* 哪些資訊要優先顯示
* 哪些資訊應該收合或延後
* 什麼狀態下需要提醒使用者
* 哪些設計會增加摩擦,應該避免
## 9. 技術需求
請包含:
* 前端
* 後端
* 資料庫
* API
* 權限
* 檔案或媒體處理
* 第三方服務
* AI 模型或 Agent 使用方式
## 10. 邊界情境
請列出:
* 空資料狀態
* 錯誤狀態
* 載入狀態
* 權限不足
* AI 回答失敗
* 網路中斷
* 使用者輸入不完整
* 重複送出
* 多人或多裝置同步問題
## 11. 驗收標準
請用 checkbox 格式輸出。
---
# Phase 3:Agent 分工設計
請把整個工作拆給不同 AI Agent。
請用表格輸出:
| 角色 | 使用工具 | 負責任務 | 輸入 | 輸出 | 注意事項 |
| -- | ---- | ---- | -- | -- | ---- |
至少包含:
1. 人類創辦人
2. Claude Code
3. Codex
4. Hermes Agent
5. 女媧 Skill / Agent Skills
6. 測試 Agent
7. 文件 Agent
8. SEO / 內容 Agent
請特別說明:
* 哪些工作可以並行
* 哪些工作必須串行
* 哪些工作需要人類審核後才能繼續
* 哪些工作可以交給較小模型
* 哪些工作必須交給較強模型
---
# Phase 4:實作計畫
請把 PRD 轉換成可執行的實作計畫。
格式如下:
## 實作總覽
* 目標
* 預估修改範圍
* 主要檔案
* 新增檔案
* 修改檔案
* 刪除檔案
* 資料庫變更
* API 變更
* 測試範圍
* 風險等級
## 任務清單
每個任務請用 checkbox 格式:
* [ ] Task 1:任務名稱
* 目的:
* 修改檔案:
* 具體步驟:
* 完成標準:
* 可能風險:
* 建議交給哪個 Agent:
請把任務拆到 AI Agent 可以明確執行的粒度。
不要只寫「完成前端」這種模糊任務。
要寫到「修改哪個檔案、增加哪個元件、處理哪個狀態、需要哪個測試」。
---
# Phase 5:Codex 審查提示詞
請產生一段可以交給 Codex 使用的審查提示詞。
目標是讓 Codex 審查 Claude Code 產出的計畫或程式碼。
Codex 審查提示詞必須包含:
1. 請檢查是否符合 PRD
2. 請檢查是否有資料流程錯誤
3. 請檢查是否有 race condition
4. 請檢查是否有權限問題
5. 請檢查是否有錯誤狀態未處理
6. 請檢查是否有安全風險
7. 請檢查是否有測試缺口
8. 請檢查是否有過度設計
9. 請檢查是否有和原始使用者價值偏離
10. 請用 Critical / High / Medium / Low 分級
請輸出可直接複製的 Codex Review Prompt。
---
# Phase 6:Implementation Review 自動測試設計
請模擬一位人類產品審查者,設計端到端測試情境。
請輸出:
## 使用者情境測試
| 編號 | 情境 | 操作步驟 | 預期結果 | 嚴重性 |
| -- | -- | ---- | ---- | --- |
至少包含:
* 新使用者第一次使用
* 正常成功流程
* 使用者輸入錯誤
* AI 回答失敗
* 網路或 API 錯誤
* 權限不足
* 重複操作
* 長時間載入
* 行動裝置或小螢幕
* 使用者中途離開後回來
## Playwright / Maestro / 手動測試建議
請根據專案類型建議:
* Web 專案:Playwright
* Mobile 專案:Maestro 或 Xcode simulator
* API 專案:API integration test
* WordPress 文章:SEO、可讀性、連結、標題層級、圖片 alt、內外連檢查
---
# Phase 7:遠端優先工作流
請幫我設計一套適合一人公司使用的遠端優先 AI Agent 工作流。
請包含:
## 1. 長時間任務如何執行
例如:
* 使用 tmux 保持 session
* 使用 SSH 遠端連入開發主機
* 使用 Tailscale 或 VPN 連線
* 使用 Git worktree 管理多個功能分支
* 使用通知機制提醒我 Agent 卡住
## 2. 手機上如何追蹤
請設計:
* 手機查看進度
* 手機批准或否決 Agent 決策
* 手機補充語音輸入
* 手機查看測試結果
## 3. 語音輸入策略
請幫我把口語想法整理成可執行規格。
如果我貼上的是語音轉文字,請先整理語意,不要糾正文法而忽略內容。
## 4. 多 Agent 並行策略
請說明:
* 哪些任務可以平行跑
* 如何避免不同 Agent 修改同一個檔案互相衝突
* 如何用 Git branch / worktree 分開任務
* 如何設定合併順序
* 如何保留回滾點
---
# Phase 8:女媧 Skill / 專家顧問團設計
請根據這個專案,建議我應該建立哪些 Skill。
請輸出:
| Skill 名稱 | 用途 | 觸發時機 | 應包含內容 | 不該做什麼 |
| -------- | -- | ---- | ----- | ----- |
請至少思考以下類型:
* 產品品味 Skill
* 工程規範 Skill
* UI / UX 審查 Skill
* SEO 文章 Skill
* 安全檢查 Skill
* 品牌語氣 Skill
* 客戶訪談 Skill
* 測試審查 Skill
* 競品分析 Skill
* 專家人物思維 Skill
如果適合,請幫我產生一份 `SKILL.md` 草稿。
`SKILL.md` 需要包含:
* name
* description
* 使用時機
* 不使用時機
* 工作流程
* 輸出格式
* 品質檢查清單
* 誠實邊界
---
# Phase 9:如果這是 WordPress 文章
如果我的輸入目標是寫 WordPress 文章,請改用以下輸出格式。
請產出:
1. 主標題
2. 三個 SEO 標題選擇
3. SEO 中繼資料說明
4. 文章標籤,請用繁體中文,並用半形逗號分隔
5. WordPress 可直接貼上的文章內容
6. 內部連結建議
7. 外部連結建議
8. 圖片或流程圖建議
9. 可以用「創作圖像」生成的圖片提示詞
10. 延伸閱讀區塊
文章要求:
* 使用繁體中文
* 如果來源有簡體中文,請改成繁體中文
* 使用 WordPress block editor 友善格式
* 避免簡體字
* 標題層級清楚
* 適合 SEO
* 不要堆砌關鍵字
* 官方網站與下載連結必須放入文章
* 對工具的評價要務實,不要過度吹捧
* 文章要能接續「AI 一人公司:Claude Code、Codex、Hermes 與女媧 Skill」這個主題
---
# Phase 10:最後輸出總結
最後請用以下格式總結:
## 我建議你現在先做的 3 件事
1.
2.
3.
## 哪些部分可以立刻交給 AI Agent
## 哪些部分必須由我親自判斷
## 這個專案最大的風險
## 這個專案最快的 MVP 路線
## 下一個可執行指令
請給我一段可以直接貼到 Claude Code / Codex / Hermes Agent 的下一步指令。
---
## 重要規則
1. 不要只給概念,要給可執行步驟。
2. 不要假設 AI 會自動理解我的產品品味,要把標準寫清楚。
3. 不要讓 Agent 直接長時間執行高風險操作,必須設計審查點。
4. 不要只檢查程式能不能跑,也要檢查使用者流程是否合理。
5. 不要把 AI 當成全自動創辦人;AI 是員工,人類才是老闆。
6. 如果資訊不足,請先提出最少量但最高價值的澄清問題。
7. 如果可以先做合理假設,就先標明假設並繼續,不要卡住。
8. 對每個輸出都要加上品質檢查清單。
9. 所有內容都用繁體中文。
10. 若引用外部工具、官方網站、GitHub 或下載連結,請列出來源與用途。
現在請根據我提供的主題,開始 Phase 1。
感想
未來真正有競爭力的人,不一定是最會寫提示詞的人,而是最會設計 AI 工作流的人。
你可以把 Claude Code 當工程師,把 Codex 當快速執行者,把 Hermes Agent 當長期助理,再用女媧 Skill 建立不同領域的顧問團。
但最後,真正的老闆還是你。
AI 一人公司的重點不是讓 AI 取代你,而是讓你從執行者升級成指揮者。
補充:
商業導師:
https://github.com/dontbesilent2025/dbskill
美工與設計:(寶玉skills)
https://github.com/JimLiu/baoyu-skills/blob/main/README.zh.md
by Rain Chu | 6 月 18, 2026 | AI , skills
baoyu-skills 產生產品圖:用 AI 快速製作 WordPress 商品視覺素材
在經營 WordPress 網站、WooCommerce 商店或內容型部落格時,產品圖往往是最花時間、也最影響轉換率的素材之一,過去要做一張產品主視覺,可能需要攝影、修圖、排版、設計師協作,甚至還要為不同平台另外裁切尺寸。
如果你的網站需要大量商品圖、文章封面圖、社群圖卡、資訊圖表,baoyu-skills 會是一個很適合導入的 AI 圖像工作流工具。
baoyu-skills 是由 Jim Liu 寶玉分享的 AI Agent 技能集,可用於 Claude Code、Codex 等 Agent 環境,協助內容創作者與網站經營者更有效率地產生圖片、文章、圖卡、簡報、資訊圖與多種發布素材。
官方 GitHub:https://github.com/jimliu/baoyu-skills
下載與更新:https://github.com/JimLiu/baoyu-skills/releases
為什麼 WordPress 網站需要 baoyu-skills?
WordPress 的優點是彈性高,但內容經營到一定規模後,最常卡住的地方不是文章本身,而是「圖片素材」。
常見情境包含:
WooCommerce 商品需要主圖、情境圖、橫幅圖
部落格文章需要 SEO 封面圖
產品教學需要流程圖或資訊圖表
社群貼文需要小紅書、Instagram、Facebook 圖卡
多語系網站需要同一張圖的不同語言版本
技術產品需要規格圖、爆炸圖、比較圖或視覺說明
baoyu-skills 的價值在於,它不是單純「叫 AI 畫一張圖」,而是把常見內容工作拆成多個 Skill,讓你可以針對不同用途選擇合適的圖片生成方式。
baoyu-skills 的主要特色
1. 可產生多種產品視覺素材
baoyu-skills 不是只有單一圖片生成指令,而是包含多種與內容、圖片、圖表相關的技能。
適合用在:
產品封面圖
商品情境圖
文章插圖
資訊圖表
社群圖卡
教學流程圖
知識漫畫
簡報圖片
商品介紹圖
對 WordPress 經營者來說,這代表同一份產品資料可以延伸成不同的行銷素材。
2. 適合產品圖與文章封面圖
如果你正在寫一篇產品介紹文章,可以使用 baoyu-cover-image 產生文章封面,也可以使用 baoyu-image-gen 或 baoyu-imagine 產生更自由的商品情境圖。
例如:
科技產品:可產生冷色系、金屬感、未來感的產品主視覺
美妝商品:可產生柔光、乾淨背景、生活情境的商品照
食品商品:可產生木質桌面、自然光、手作感的商品圖
教育服務:可產生圖解式封面與資訊圖
SaaS 產品:可產生 UI mockup、介面展示與功能圖解
3. 支援圖表與流程類型內容
遇到流程、比較、架構、教學步驟時,建議不要只用文字說明,可以改用「創作圖像」的方式產生視覺圖。
例如這篇文章中的工作流程可視覺化如下:
這類流程非常適合做成資訊圖,放在 WordPress 文章中,不但可以增加停留時間,也能讓讀者更快理解工具的實際用途。
4. 可與 WordPress 內容流程整合
baoyu-skills 本身不是 WordPress 外掛,而是 AI Agent 的技能集。實際用法通常是先在本機或開發環境產生圖片,再把圖片上傳到 WordPress 媒體庫。
建議流程如下:
在 Claude Code、Codex 或其他支援 Skills 的 Agent 中安裝 baoyu-skills
準備商品描述、文章 Markdown 或產品規格
使用對應指令產生圖片
檢查圖片比例、文字、品牌色與可讀性
將圖片輸出為 WebP、PNG 或 JPG
上傳到 WordPress 媒體庫
套用到文章特色圖片、WooCommerce 商品圖、Elementor 區塊或首頁 Banner
如果你的網站使用 Elementor,也可以直接把產出的圖片放進 Elementor 的 Image、Hero、CTA、Gallery 或 Loop Grid 區塊中。
安裝與下載
官方建議安裝方式如下:
npx skills add jimliu/baoyu-skills
官方 GitHub:https://github.com/jimliu/baoyu-skills
下載與版本更新:https://github.com/JimLiu/baoyu-skills/releases
如果你使用 Claude Code,也可以在 Agent 中加入 marketplace:
/plugin marketplace add JimLiu/baoyu-skills
接著安裝:
/plugin install baoyu-skills@baoyu-skills
官方文件提醒,baoyu-skills 內含多個 Skill,實務上建議按需安裝,不一定要一次載入所有技能,避免佔用過多 Agent 上下文。
關鍵指令整理
以下是用於產品圖與 WordPress 內容製作時最常用的指令方向。
1. 產生文章封面圖
/baoyu-cover-image path/to/article.md
指定風格:
/baoyu-cover-image path/to/article.md --style blueprint
指定比例:
/baoyu-cover-image path/to/article.md --aspect 16:9
不要加標題文字:
/baoyu-cover-image path/to/article.md --no-title
適合用途:
WordPress 文章特色圖片
部落格封面
首頁文章列表縮圖
SEO 文章主視覺
2. 產生產品情境圖
/baoyu-image-gen "黑色無線耳機,霧面金屬質感,放在白色桌面上,自然柔光,商業產品攝影風格"
適合用途:
WooCommerce 商品主圖
商品詳情頁情境圖
首頁商品橫幅
廣告素材
3. 產生自由風格產品圖
/baoyu-imagine "一款高階 AI 筆電放在現代辦公桌上,背景有柔和光影,科技感,高級商業攝影"
適合用途:
品牌形象圖
活動視覺
產品概念圖
Landing Page 主視覺
4. 產生資訊圖表
/baoyu-infographic path/to/content.md
指定版型與風格:
/baoyu-infographic path/to/content.md --layout flow --style technical-schematic
適合用途:
產品規格比較
教學步驟
服務流程
軟體架構圖
WordPress 教學文章配圖
5. 產生社群圖卡
/baoyu-xhs-images posts/product-intro.md
指定風格:
/baoyu-xhs-images posts/product-intro.md --style notion
指定流程版型:
/baoyu-xhs-images posts/product-intro.md --layout flow
適合用途:
小紅書圖卡
Instagram 輪播圖
Facebook 貼文圖
WordPress 文章延伸社群素材
6. 圖片壓縮與最佳化
/baoyu-compress-image product-image.png
適合用途:
將圖片轉為 WebP
壓縮 WordPress 圖片
降低網頁載入時間
改善 Core Web Vitals
WordPress 使用場景範例
場景一:WooCommerce 商品頁
你可以先準備商品描述:
產品名稱:黑色真無線藍牙耳機
特色:降噪、長續航、霧面金屬外殼、適合通勤與辦公
圖片風格:高級商業攝影、白色背景、柔和陰影、乾淨構圖
接著用 baoyu-skills 產生:
商品主圖
生活情境圖
功能賣點圖
規格比較圖
社群推廣圖
最後將圖片上傳到 WordPress 媒體庫,套用到 WooCommerce 商品圖集。
場景二:WordPress 部落格文章
如果你要寫一篇「如何挑選無線網卡」的文章,可以使用:
/baoyu-cover-image article.md --style blueprint --aspect 16:9
再使用:
/baoyu-infographic article.md --layout comparison --style technical-schematic
這樣可以同時產生文章封面與比較型資訊圖,讓文章更適合 SEO 排名與社群分享。
場景三:Elementor 首頁橫幅
如果你使用 Elementor 製作首頁,可以先用 baoyu-skills 產生 16:9 或 21:9 的 Hero Banner。
提示詞範例:
請產生一張 WordPress 首頁 Hero Banner:
主題是 AI 產品圖自動生成,
畫面包含商品攝影棚、AI 工作流、WordPress 網站介面,
風格為現代、乾淨、科技感、商業級視覺,
不要過多文字,保留右側放標題的空間。
產出後可放進 Elementor 的 Hero Section,搭配標題、按鈕與 CTA。
baoyu-skills 產品圖工作流程
這樣做的好處是,每次製作商品頁時,不必重新思考整套流程,只要替換產品資料與風格設定,就能快速產出一致的視覺素材。
產品圖提示詞範例
科技產品
黑色 USB WiFi 網路卡,雙天線,放在乾淨白色桌面上,背景有筆電與柔和光影,科技感,高級商業攝影,清晰產品細節,適合電商商品頁
美妝產品
玻璃精華液瓶,琥珀色瓶身,放在大理石平台上,旁邊有綠色植物與柔和自然光,乾淨高級,美妝產品攝影風格
食品產品
手工餅乾禮盒,木質桌面,自然光,溫暖色調,旁邊有咖啡杯與包裝紙,適合品牌形象與電商頁面
軟體服務
AI 批改系統的產品主視覺,畫面包含老師桌面、筆電介面、文件上傳、AI 分析圖示,明亮乾淨,專業 SaaS 風格
使用 baoyu-skills 時要注意什麼?
1. 不要只寫「幫我產生產品圖」
好的提示詞應該包含:
產品名稱
產品材質
使用場景
光線
背景
圖片比例
風格
不要出現的元素
例如:
請產生一張 16:9 商品橫幅圖:
產品是一台銀色 AI 筆電,
放在乾淨的辦公桌上,
背景有柔和藍色光影與抽象 AI 線條,
風格為高級科技產品攝影,
不要出現人物、浮水印、亂碼文字。
2. 產品圖要保留 WordPress 版面空間
如果圖片要放在文章封面或首頁 Banner,建議在提示詞中加上:
或:
這樣後續在 WordPress、Elementor 或區塊編輯器中排版會更方便。
3. 圖片要檢查文字
AI 圖片中的文字有時會出現亂碼,因此若是商品圖、封面圖或廣告圖,建議分成兩階段:
先產生無文字圖片
再用 WordPress、Canva、Photoshop 或 Elementor 加上正式文字
這樣可以避免圖片中文字錯誤影響品牌專業度。
4. 圖片上傳 WordPress 前要壓縮
建議輸出後轉成 WebP,並控制圖片尺寸。
常用建議:
文章封面:1200 × 675
商品圖:1200 × 1200
首頁 Banner:1920 × 800
社群圖卡:1080 × 1350
小紅書圖卡:1080 × 1440
圖片壓縮後再上傳,可改善網站速度與 SEO 表現。
適合誰使用?
baoyu-skills 特別適合以下使用者:
WordPress 網站經營者
WooCommerce 電商賣家
部落格作者
SEO 內容團隊
AI 工具玩家
小型品牌主
產品行銷人員
技術產品代理商
需要大量多語系素材的網站團隊
如果你經常需要為不同文章、商品或社群平台製作圖片,baoyu-skills 可以讓你的視覺內容生產流程更標準化。
by Rain Chu | 6 月 18, 2026 | AI , skills
現在越來越多工程師會使用 Claude Code、Cursor、Codex、Gemini CLI 或其他 AI coding agent 來協助寫程式。只要輸入一句「幫我做登入功能」、「幫我修這個 bug」,AI 就能快速產生程式碼,看起來效率很高。
但真正把 AI 放進日常開發流程後,很快就會遇到幾個問題:
需求還沒釐清,AI 就開始寫程式。 測試沒有先寫,甚至根本沒寫。 AI 說「完成了」,但實際執行才發現功能壞掉。 修改一個 bug,結果又製造出另一個 bug。 程式碼看起來能跑,但沒留下設計紀錄,也很難交接。
這些問題通常不是模型不夠聰明,而是工作流程不夠可靠。
Superpowers 要解決的,正是這件事。
Superpowers 是什麼?
Superpowers 是目前 Claude Code 社群裡很熱門的 Skills 框架之一,專門用來強化 AI 的開發流程。它不是單純讓 AI 「更會寫程式」,而是讓 AI 在寫程式之前、寫程式之中、寫完之後,都按照一套更有紀律的流程工作。
你可以把 Superpowers 想成一套給 AI coding agent 使用的「開發工作手冊」。
它會提醒或要求 AI 在不同階段使用對應的 Skill,例如:
需求不清楚時,先進行 brainstorming。 要開始實作前,先寫 writing-plans。 要寫功能時,使用 test-driven-development。 遇到 bug 時,進入 systematic-debugging。 說完成之前,先執行 verification-before-completion。 需要隔離工作時,使用 using-git-worktrees。 需要審查時,使用 requesting-code-review。
也就是說,Superpowers 的價值不只是「增加功能」,而是讓 AI 開發變成一個可檢查、可追蹤、可驗證的流程。
為什麼需要 Superpowers?
很多人使用 AI 寫程式的方式,其實還停留在「提需求,等結果」。
例如:
幫我新增一個學生作業上傳功能。
AI 可能很快就改了一堆檔案,新增 API、修改 UI、調整資料庫欄位,看起來很有效率。但問題是:
它真的理解需求嗎? 有沒有考慮錯誤情境? 有沒有測試? 有沒有驗證現有功能沒有被破壞? 有沒有留下文件? 有沒有清楚說明改了哪些地方?
如果這些問題沒有被處理,AI 寫得越快,後續返工可能越多。
Superpowers 的核心理念是:
聰明是模型的事,可靠是流程的事。
模型可以幫你寫程式,但流程要讓它知道什麼時候該停下來、什麼時候該問問題、什麼時候該測試、什麼時候才算真的完成。
Superpowers 的核心流程
Superpowers 的開發流程可以簡化成四個階段:
1. Design:先設計,不急著寫
當你要做新功能時,不要一開始就叫 AI 寫程式。Superpowers 會鼓勵 AI 先透過 brainstorming 釐清需求。
這個階段的重點包括:
確認真正要解決的問題 一次只問一個問題 避免一次丟出太多開放式問題 提出不同方案與取捨 砍掉不必要的功能,遵守 YAGNI 原則
這可以避免 AI 一開始就走錯方向。
2. Plan:把任務拆成可執行步驟
需求確認後,下一步不是直接寫 code,而是建立實作計畫。
常用 Skill:
/superpowers:writing-plans
這個 Skill 會把任務拆成一個個很清楚的小步驟,包括:
要修改哪個檔案 要新增哪些測試 每一步要執行什麼指令 預期會看到什麼結果 完成標準是什麼
好的計畫不是寫給「很懂專案的人」看的,而是寫給「新開的 AI session 或 junior engineer」也能照著完成的人看的。
這一點非常重要。因為 AI 很容易在長對話中忘記上下文,或在不同 session 之間失去脈絡。明確的 plan 可以降低這個問題。
3. Test:先測試,再實作
Superpowers 很重視 test-driven-development,也就是 TDD。
它希望 AI 不要直接寫功能,而是:
先寫一個會失敗的測試 執行測試,確認真的失敗 寫最小可行程式碼讓測試通過 再次執行測試 重構與清理
這種流程看起來比較慢,但對 AI 開發非常重要。
因為 AI 最大的風險之一是「看起來完成了,但其實沒有驗證」。
TDD 可以把完成標準變成具體的測試,而不是只靠 AI 自己說「已經完成」。
4. Quality:完成之前必須驗證
AI 很常說:
功能已完成。
但實際上可能沒有跑測試、沒有 build、沒有 lint,甚至沒有啟動專案確認。
Superpowers 的 verification-before-completion 就是為了解決這個問題。
它會要求 AI 在宣稱完成之前,先執行必要驗證,例如:
npm test
npm run build
npm run lint
npm run typecheck
如果是後端專案,也可以包含:
pytest
go test ./...
cargo test
如果是前端專案,則可能需要:
npm run test
npm run build
npm run dev
重點不是指令本身,而是「不能沒有驗證就說完成」。
Superpowers 常用 Skill 整理
Skill 用途 適合情境 brainstorming 釐清需求 新功能、新模組、新流程 writing-plans 撰寫實作計畫 需求明確後,準備拆任務 test-driven-development 測試驅動開發 新功能、重構、修 bug systematic-debugging 系統化除錯 測試失敗、bug 無法定位 verification-before-completion 完成前驗證 AI 說完成之前 requesting-code-review 請 AI 做程式碼審查 功能完成後 using-git-worktrees 隔離開發環境 多任務、多分支、避免互相污染 subagent-driven-development 透過子代理執行計畫 任務可拆分、需要分工 executing-plans 依照計畫執行 想照步驟穩定完成 finishing-a-development-branch 收尾開發分支 功能完成後準備合併
關鍵指令:find skills
安裝 Superpowers 後,最重要的第一個指令是:
這個指令可以讓 AI 掃描目前可用的 Skills,幫你知道現在有哪些能力可以使用。
建議你在每次進入新專案,或剛安裝 Superpowers 後,都先輸入:
接著可以再問:
請列出目前可用的 Superpowers skills,並說明每個 skill 適合在什麼情境使用。
或是:
請根據目前這個專案,建議我應該優先使用哪些 Superpowers skills。
這樣可以避免你裝了 Skills,卻不知道什麼時候該用。
Claude Code 常用安裝方式
官方 GitHub:https://github.com/obra/superpowers
下載與安裝可以從官方 GitHub 頁面開始:https://github.com/obra/superpowers
如果你使用 Claude Code,可以透過官方 plugin marketplace 安裝:
/plugin install superpowers@claude-plugins-official
也可以加入 Superpowers marketplace:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
安裝完成後,建議先執行:
確認 Superpowers 是否正確載入。
建議的日常使用流程
如果你是第一次把 Superpowers 放進專案,可以先採用以下流程:
第一步:先找 Skills
請 AI 列出目前能使用的 Skills,並說明哪些適合目前專案。
第二步:新功能先 brainstorming
你可以這樣對 Claude Code 說:
我要新增一個學生作業上傳與 AI 批改功能,請使用 Superpowers 的 brainstorming 先幫我釐清需求,不要直接寫程式。
這樣可以避免 AI 直接動手,先把需求問清楚。
第三步:確認設計後寫計畫
/superpowers:writing-plans
或直接說:
請根據剛剛確認的設計,使用 writing-plans 幫我建立實作計畫。
第四步:依照計畫執行
如果任務較大,可以使用:
請使用 subagent-driven-development 依照這份 plan 執行。
如果任務比較小,也可以說:
請使用 executing-plans 逐步執行,完成每一步都回報。
第五步:完成前要求驗證
在你說完成之前,請使用 verification-before-completion,實際執行測試、build、lint,並回報結果。
這是整個流程中最重要的一步。
AI 說完成不代表真的完成。 有跑過驗證,才比較接近完成。
Superpowers 適合哪些人?
Superpowers 特別適合以下情境:
長期維護的產品 多人協作的專案 重視測試與品質的團隊 需要讓 AI 參與正式開發流程 常常遇到 AI 寫完但不能跑的問題 想把 AI 從「寫 code 工具」變成「開發夥伴」
如果你只是想快速做一個一次性 demo,Superpowers 可能會顯得比較重。因為它會要求你先釐清需求、寫計畫、寫測試、做驗證,流程比單純 vibe coding 更嚴謹。
但如果你的目標是打造可維護、可驗證、可交接的程式碼,Superpowers 的價值就很明顯。
Superpowers 的限制
Superpowers 不是萬靈丹。
它可以讓 AI 更有紀律,但仍然有幾個限制:
第一,它主要依靠 AI 遵守規則。 如果 AI 沒有正確載入 Skill,或跳過流程,還是需要人類提醒。
第二,它需要專案本身有良好的測試與建置指令。 如果你的專案沒有 test、build、lint,Superpowers 很難幫你驗證。
第三,它會增加前期流程成本。 小任務可能會覺得太重,但大型功能會因此更穩。
第四,開發者仍然要審查結果。 Superpowers 可以減少 AI 亂寫,但不能取代人類工程判斷。
所以最好的使用方式不是完全放手,而是把 Superpowers 當成一套「AI 開發 SOP」。
一張圖理解 Superpowers 流程
這套流程的核心不是讓 AI 一次寫更多程式,而是讓 AI 每一步都可被確認、可被驗證、可被追蹤。
參考資源
官方 GitHub:https://github.com/obra/superpowers
by Rain Chu | 6 月 18, 2026 | AI , skills
你可以把 find-skills 想成是 Agent 專用的「Skill App Store」。
當你未來想問:
「有沒有適合做 React 優化的 Skill?」
「有沒有可以幫我寫 changelog 的 Skill?」
「有沒有支援 PR Review、測試、自動化部署的 Skill?」
安裝 find-skills 之後,Agent 就可以根據你的需求,去搜尋相關 Skills,並提供安裝建議。
為什麼第一個要裝 find-skills?
一般人在剛開始使用 Agent Skills 時,最常遇到的問題不是「不會安裝」,而是「不知道有哪些 Skills 可以用」。
以前要找 Skills,可能要靠別人分享、GitHub 搜尋、社群文章,或自己慢慢翻各種資源庫。這種方式有幾個缺點:
很容易找不到真正適合的 Skill
搜尋過程會打斷目前工作流程
不知道哪些 Skill 比較可信
不知道該用什麼關鍵字搜尋
找到之後還要自己判斷怎麼安裝
find-skills 解決的就是這個問題。
它讓 Agent 可以根據目前任務,協助你搜尋、比較、推薦甚至安裝其他 Skills。換句話說,安裝它之後,你的 Agent 就不只是被動執行任務,而是能開始主動幫你擴充能力。
find-skills 是什麼?
find-skills 是 Vercel Labs Skills 專案中的一個官方 Skill。
官方頁面說明:https://github.com/vercel-labs/skills/blob/main/skills/find-skills/SKILL.md
它的主要功能是協助使用者從 open agent skills 生態系中發現與安裝 Skills。當你問 Agent「我要怎麼做某件事?」、「有沒有某種 Skill?」、「能不能幫我找某類工具?」時,find-skills 就可以派上用場。
它適合用在這些情境:
你想找某個特定用途的 Skill
你想知道某個任務是否已經有人做成 Skill
你想擴充 Agent 的能力
你想搜尋工具、範本或工作流程
你想讓 Agent 幫你推薦適合目前任務的 Skill
安裝 find-skills
建議直接使用 Vercel Labs 官方 Skills CLI 安裝。
npx skills add https://github.com/vercel-labs/skills --skill find-skills
這是我建議所有 Agent Skills 使用者第一個安裝的指令。
官方頁面:https://github.com/vercel-labs/skills/blob/main/skills/find-skills/SKILL.md
下載 / 安裝來源:https://github.com/vercel-labs/skills
SKILL.md 原始檔下載:https://raw.githubusercontent.com/vercel-labs/skills/main/skills/find-skills/SKILL.md
關鍵指令整理
安裝完成後,最常用的指令有以下幾個。
1. 搜尋 Skills
npx skills find "find skills"
也可以換成更具體的搜尋字,例如:
npx skills find "react performance"
npx skills find "seo meta"
npx skills find "pr review"
npx skills find "changelog"
npx skills find "wordpress"
搜尋關鍵字越具體,結果通常越準。
例如你要找 SEO 相關 Skills,不建議只搜尋:
可以改成:
npx skills find "seo meta"
npx skills find "seo tags"
npx skills find "wordpress seo"
這樣比較容易找到符合任務的 Skill。
2. 安裝 Skill
如果你已經知道要安裝哪個 Skill,可以使用:
例如:
npx skills add https://github.com/vercel-labs/skills --skill find-skills
3. 列出已安裝 Skills
這個指令可以查看目前已安裝的 Skills。
不過要注意,如果某些 Skills 不是透過 npx skills add 安裝的,可能不一定會被完整列出。
4. 檢查更新
這個指令可以檢查已安裝的 Skills 是否有更新。
5. 更新 Skills
這個指令會更新已安裝的 Skills。
建議不要盲目更新所有 Skills。更新前最好先確認來源是否可信、更新內容是否合理,尤其是在正式專案或公司環境中使用時,更應該謹慎。
使用 find-skills 的推薦流程
我會建議用這樣的流程:
Step 1:先描述你的需求
不要只丟一個太籠統的詞。
例如不要只說:
可以改成:
npx skills find "ui design system"
npx skills find "accessibility review"
npx skills find "figma to react"
Step 2:查看搜尋結果
搜尋結果出現後,不要只看名稱。
建議至少確認:
Skill 名稱
來源作者或組織
安裝數
GitHub repo
是否有文件
是否近期仍有人維護
是否符合你的實際任務
Step 3:優先選可信來源
如果是正式專案使用,我會優先選擇這幾類來源:
官方組織
大型開源專案
GitHub 星數較高的專案
安裝數較多的 Skill
有清楚文件與範例的 Skill
不要只因為搜尋結果排在前面就直接安裝。
Step 4:安裝後再測試
安裝完成後,建議先用小任務測試。
例如你安裝了 SEO 相關 Skill,可以先讓 Agent 幫你產生一篇文章的:
SEO 標題
Meta description
WordPress 標籤
文章摘要
內部連結建議
確認結果符合預期後,再放進正式工作流程。
find-skills 適合哪些人?
我認為 find-skills 特別適合這幾種使用者。
1. 剛開始使用 Agent Skills 的人
你不需要一開始就知道所有 Skills。先裝 find-skills,讓 Agent 幫你找。
2. 經常做不同任務的開發者
如果你平常會做:
React
Next.js
WordPress
Docker
GitHub Actions
測試
部署
文件產生
Code Review
那 find-skills 很適合當成你的 Skill 搜尋入口。
3. 想打造個人 Agent 工作流的人
如果你希望 Agent 不只是聊天,而是變成真正的工作助理,Skills 會是很重要的擴充方式。
find-skills 則是幫你管理這個擴充入口的第一個工具。
4. 想建立團隊標準工具集的人
公司或團隊也可以先用 find-skills 找出常用 Skills,再建立自己的標準清單。
例如:
前端開發 Skills
測試 Skills
文件 Skills
DevOps Skills
SEO Skills
WordPress Skills
安全檢查 Skills
這樣可以讓團隊的 Agent 能力更一致。
使用 find-skills 的注意事項
find-skills 很方便,但不是所有搜尋結果都應該直接安裝。
使用時建議注意以下幾點。
1. 不要盲目相信搜尋結果
搜尋到 Skill,只代表它可能相關,不代表它一定適合你的任務。
正式使用前,仍然要確認來源、文件與內容。
2. 安裝前先看來源
尤其是來自不熟悉作者的 Skill,要更謹慎。
如果 Skill 會執行命令、讀寫檔案、存取專案內容,就更應該先檢查內容。
3. 搜尋關鍵字要具體
find-skills 的搜尋品質,很大程度取決於你的關鍵字。
比起搜尋:
更建議搜尋:
npx skills find "wordpress seo meta"
比起搜尋:
更建議搜尋:
npx skills find "playwright e2e test"
4. 更新 Skills 要小心
npx skills update 雖然方便,但在正式專案中不要隨便全部更新。
建議先檢查:
確認更新內容後,再決定是否更新。
我的建議:find-skills 是 Agent Skills 的第一個必裝工具
如果你只打算先安裝一個 Skill,我會選 find-skills。
因為它能讓 Agent 具備「找工具」的能力。
這跟一般單一功能 Skill 不一樣。一般 Skill 是讓 Agent 多一項能力,而 find-skills 是讓 Agent 開始知道「還有哪些能力可以被安裝」。
這也是為什麼我會把它稱為 Agent 的 Skill App Store。
先安裝它,之後要找 SEO、WordPress、React、測試、部署、文件、設計、Code Review 等 Skills,都會更有效率。
by Rain Chu | 6 月 18, 2026 | AI , skills
skill-creator 是 Anthropic 官方 skills 專案中的一個 Skill 開發助手,可以協助使用者建立 Claude Code 可使用的自訂 Skill,透過 Skill,你可以把固定工作流程、專業知識、工具使用方式、文件格式與腳本包裝成可重複使用的能力,讓 Claude 在特定任務上更穩定、更一致,也更符合你的實際工作需求。
什麼是 Skill?
在 Claude Code 的使用情境中,Skill 可以理解成「給 AI 使用的操作說明書」。
它不是單純的一段 prompt,而是一個可重複使用的能力包。通常一個 Skill 會包含:
skill-name/
├── SKILL.md # 核心說明文件,必要
├── scripts/ # 可執行腳本,選用
├── references/ # 參考文件或知識資料,選用
├── assets/ # 圖片、範本、範例檔案等資源,選用
其中最重要的是 SKILL.md。 這個檔案會告訴 Claude:
這個 Skill 是做什麼的
什麼情境下應該使用
要遵守哪些流程
輸出格式是什麼
是否需要使用特定工具、腳本或範本
簡單來說,Skill 的目標是讓 Claude 不只是「聽懂一次指令」,而是能長期穩定地執行某一類工作。
skill-creator 是什麼?
skill-creator 是 Anthropic 官方提供的 Skill 建立助手,收錄在官方 skills 專案中。
它的作用是協助你從零開始建立一個 Skill,包含:
釐清 Skill 的用途
設計觸發情境
撰寫 SKILL.md
建立參考文件
設計測試案例
評估 Skill 使用前後的效果
最後打包成 .skill 檔案
如果你只是手動寫 SKILL.md,很容易漏掉使用情境、輸出格式、邊界條件或測試流程。 而 skill-creator 的價值就在於,它會像一個 Skill 顧問一樣,逐步問你問題,幫你把需求整理成可以實際使用的 Skill。
官方網頁與下載連結
官方 GitHub 專案:https://github.com/anthropics/skills/tree/main
skill-creator 官方目錄:https://github.com/anthropics/skills/tree/main/skills/skill-creator
下載 Anthropic skills 專案 ZIP:https://github.com/anthropics/skills/archive/refs/heads/main.zip
安裝 skill-creator
如果你已經在使用 Claude Code,可以透過以下方式安裝 skill-creator。
方法一:使用 npx skills add
npx skills add https://github.com/anthropics/skills --skill skill-creator
方法二:使用 claude install
claude install anthropics/skills/skill-creator
安裝完成後,就可以在 Claude Code 中呼叫:
接著 Claude 會開始引導你建立 Skill。
用 skill-creator 建立 Skill 的基本流程
使用 skill-creator 建立 Skill,通常可以分成以下幾個階段。
1. 說明你想建立的 Skill
一開始,你可以用自然語言描述需求,例如:
我想建立一個 Skill,用來把會議逐字稿整理成結構化會議紀要。
或是:
我想建立一個 Skill,用來分析 WordPress 網站錯誤訊息,並提供排查步驟。
這時候不需要一次寫得非常完整,因為 skill-creator 會繼續追問細節。
2. 回答 skill-creator 的需求問題
skill-creator 通常會確認幾個重點:
這個 Skill 主要要完成什麼任務?
使用者在什麼情境下會觸發它?
輸入資料可能是文字、檔案、程式碼還是圖片?
輸出格式要用 Markdown、表格、JSON、Word 文件,還是其他格式?
是否有固定流程、固定語氣或固定檢查清單?
是否需要使用特定工具、腳本或外部文件?
這一步非常重要。 如果需求沒有講清楚,後面 Skill 產生的結果就可能不穩定。
3. 自動產生 SKILL.md 草稿
確認需求後,skill-creator 會協助產生 SKILL.md。
一個基本的 SKILL.md 會長得像這樣:
---
name: meeting-minutes
description: Convert meeting transcripts into structured meeting minutes with decisions and action items.
---
# Meeting Minutes Skill
Use this skill when the user provides a meeting transcript and wants a structured meeting summary.
## Output Format
Include the following sections:
1. Meeting topic
2. Date and time
3. Participants
4. Key discussion points
5. Decisions
6. Action items with owner and deadline
## Guidelines
- Keep the summary concise.
- Preserve important decisions.
- Do not invent missing attendees or dates.
- If information is missing, mark it as "未提供".
這份 SKILL.md 就是 Claude 之後使用 Skill 時會讀取的核心說明。
4. 加入參考資料與範本
如果你的 Skill 需要固定格式,可以把範本放進 references/ 或 assets/。
例如:
meeting-minutes/
├── SKILL.md
├── references/
│ └── meeting-template.md
├── assets/
│ └── company-style-guide.pdf
常見的參考資料包括:
公司品牌規範
文件格式範本
常用表格
API 使用說明
程式碼規範
工作流程 SOP
檢查清單
這樣 Claude 在執行任務時,不只會依照 prompt 回答,也會參考 Skill 內部的固定資料。
5. 設計測試案例
建立 Skill 後,最好不要馬上投入正式工作,而是先做測試。
你可以準備幾組測試資料,例如:
測試一:正常格式的會議逐字稿
測試二:缺少參與人資訊的會議紀錄
測試三:內容很長、決議很多的會議
測試四:只有零散重點,沒有完整逐字稿
測試的目的不是只看 Claude 有沒有回答,而是要比較:
有使用 Skill 時,結果是否更穩定?
輸出格式是否一致?
是否遵守你指定的規則?
是否能處理邊界情況?
是否有少編造、少漏項?
6. 根據測試結果修改 Skill
第一次產生的 Skill 通常不會完美。
常見需要調整的地方包括:
描述太模糊,導致 Claude 不知道何時使用
輸出格式不夠明確
邊界條件沒有寫清楚
範例太少
沒有說明錯誤情況要怎麼處理
沒有限制 Claude 不要自行補資料
建議你把 Skill 當成一份「可持續最佳化的 SOP」。 每次遇到輸出不符合預期,就回頭修改 SKILL.md。
7. 打包成 .skill 檔案
當 Skill 測試穩定後,就可以打包成 .skill 檔案,方便匯入、分享或部署。
打包後的 Skill 就像一個可攜式能力包,可以用在支援 Skill 的 Claude 環境中。
skill-creator 適合用在哪些情境?
skill-creator 很適合用來建立以下類型的 Skill:
文件處理類
例如:
會議紀要整理
合約摘要
報告格式化
WordPress 部落格文章產生
SEO 文章檢查
論文格式整理
開發工作類
例如:
Code Review
安全檢查
API 文件產生
Git commit message 規範
Docker 部署檢查
WordPress 錯誤排查
企業流程類
例如:
客服回覆 SOP
品牌語氣檢查
行銷企劃產生
業務提案格式
專案週報整理
個人自動化類
例如:
每週工作回顧
讀書筆記整理
投資研究筆記格式化
學習計畫產生
旅遊規劃模板
建立 Skill 時的實用建議
1. description 要寫清楚
description 不只是說明文字,它會影響 Claude 判斷什麼時候該使用這個 Skill。
不建議這樣寫:
建議改成:
description: Use this skill when the user provides meeting transcripts and wants structured meeting minutes with decisions, discussion points, and action items.
越清楚,Claude 越容易正確觸發。
2. 輸出格式要固定
如果你想要表格,就直接指定表格欄位。 如果你想要 Markdown,就明確寫出標題層級。 如果你想要 JSON,就提供完整 schema。
例如:
## Output Format
Return the result in Markdown with the following sections:
# 會議紀要
## 一、會議基本資訊
## 二、討論重點
## 三、決議事項
## 四、待辦事項
3. 明確說明不要編造資料
這一點很重要,尤其是處理會議、合約、財務、法律或客戶資料時。
可以在 Skill 中加入:
## Accuracy Rules
- Do not invent missing information.
- If a field is not provided, write "未提供".
- Preserve names, dates, numbers, and deadlines exactly as given.
4. 加入好範例與壞範例
Skill 裡面可以放 Examples,讓 Claude 更容易理解你要的品質。
例如:
## Examples
Good:
- Clear action item with owner and deadline.
- Concise summary without unnecessary commentary.
Bad:
- Inventing a deadline that was not mentioned.
- Mixing discussion points with final decisions.
常用指令整理
安裝 skill-creator
npx skills add https://github.com/anthropics/skills --skill skill-creator
使用 claude install 安裝
claude install anthropics/skills/skill-creator
呼叫 skill-creator
從官方 GitHub 下載 skills 專案
git clone https://github.com/anthropics/skills.git
或直接下載 ZIP:
https://github.com/anthropics/skills/archive/refs/heads/main.zip
做好 Skill 後,如何移植到其他系統?
建立好 Skill 之後,不一定只能放在 Claude Code 裡使用。 如果 Skill 的設計夠清楚,也可以移植到其他 Agent 系統,例如 Hermes Agent、Codex,或是你自己架設的本地 AI Agent 平台。
不過要注意一件事:Skill 的核心不是某一個平台的格式,而是裡面的工作流程、判斷規則、輸出格式、參考資料與可執行腳本。
也就是說,真正有價值的是這些內容:
SKILL.md
references/
scripts/
assets/
examples/
只要把這些內容轉成目標 Agent 系統可以讀懂的格式,就可以完成移植。
Skill 移植的核心概念
一個 Skill 通常可以拆成五個部分:
1. 任務說明:這個 Skill 是做什麼的
2. 觸發條件:什麼情況下應該使用
3. 操作流程:執行任務時要照什麼步驟
4. 輸出格式:最後要產生什麼格式
5. 工具資源:是否需要腳本、範本、參考文件或 API
不同 Agent 系統的格式可能不同,但這五個部分通常都可以保留下來。
因此,移植 Skill 的重點不是「直接複製檔案」,而是把原本的 SKILL.md 改寫成目標系統的規則檔、角色設定、工具說明或 system prompt。
建議的 Skill 通用資料夾結構
為了方便未來移植,建議你在建立 Skill 時,就使用比較通用的結構:
my-skill/
├── SKILL.md
├── README.md
├── references/
│ └── knowledge-base.md
├── examples/
│ ├── input-1.md
│ └── output-1.md
├── scripts/
│ └── helper.py
├── assets/
│ └── template.md
└── manifest.json
其中:
SKILL.md:給 Claude 或支援 Skill 的 Agent 使用
README.md:給人類維護者閱讀
references/:放背景知識、規則、範本
examples/:放輸入與輸出範例
scripts/:放可執行工具
assets/:放模板、圖片、表格等資源
manifest.json:給其他 Agent 系統讀取的設定檔
如果你未來要移植到 Hermes Agent 或 Codex,這種結構會比較容易轉換。
範例:建立一個通用 manifest.json
可以在 Skill 裡面額外放一個 manifest.json,用來描述這個 Skill 的基本資訊。
{
"name": "wordpress-seo-writer",
"version": "1.0.0",
"description": "Generate Traditional Chinese WordPress blog posts with SEO title, tags, meta description, and structured article format.",
"language": "zh-TW",
"entry": "SKILL.md",
"references": [
"references/seo-guidelines.md"
],
"examples": [
"examples/input-1.md",
"examples/output-1.md"
],
"tools": [
{
"name": "keyword_checker",
"type": "script",
"path": "scripts/keyword_checker.py"
}
]
}
這個檔案不一定是 Claude Code 必要的,但它很適合給自建 Agent 系統使用。 例如 Hermes Agent 可以讀取 manifest.json,知道這個 Skill 的名稱、用途、入口檔案、參考資料與可用工具。
移植到 Hermes Agent
如果你使用的是自建的 Hermes Agent,建議把 Skill 當成一個「Agent 能力模組」來管理。
可以設計成以下結構:
hermes-agent/
├── agents/
│ └── writer-agent/
│ ├── system.md
│ ├── tools.json
│ └── skills/
│ └── wordpress-seo-writer/
│ ├── SKILL.md
│ ├── manifest.json
│ ├── references/
│ ├── examples/
│ └── scripts/
Hermes Agent 在執行任務時,可以做三件事:
1. 根據使用者輸入,判斷是否需要啟用某個 Skill
2. 讀取該 Skill 的 SKILL.md 與 references/
3. 將 Skill 內容合併進 Agent 的 system prompt 或 task prompt
例如使用者輸入:
請幫我寫一篇 WordPress SEO 文章,主題是 skill-creator。
Hermes Agent 可以比對 Skill 的 description,找到 wordpress-seo-writer,然後載入:
skills/wordpress-seo-writer/SKILL.md
skills/wordpress-seo-writer/references/seo-guidelines.md
skills/wordpress-seo-writer/examples/output-1.md
接著再讓模型依照這些規則產生文章。
Hermes Agent 的 Skill 載入邏輯範例
如果是自己開發 Hermes Agent,可以用簡單的流程實作:
User Request
↓
Intent Router
↓
Skill Matcher
↓
Load SKILL.md
↓
Load references / examples / scripts
↓
Compose Agent Prompt
↓
Run Model
↓
Return Result
也可以設計一個簡單的 Skill Registry:
{
"skills": [
{
"name": "wordpress-seo-writer",
"description": "Write Traditional Chinese WordPress SEO articles.",
"path": "./skills/wordpress-seo-writer",
"trigger_keywords": [
"WordPress",
"SEO文章",
"部落格文章",
"中繼描述",
"標籤"
]
},
{
"name": "code-review-security",
"description": "Review code for security, maintainability, and deployment risks.",
"path": "./skills/code-review-security",
"trigger_keywords": [
"code review",
"安全檢查",
"漏洞",
"重構"
]
}
]
}
這樣 Hermes Agent 就可以根據關鍵字、語意比對或任務分類,自動決定要不要載入某個 Skill。
移植到 Codex
如果要移植到 Codex,建議分成兩層處理:
1. 專案層級規則:放進 AGENTS.md
2. 任務型 Skill:保留成獨立 Skill 資料夾
Codex 會讀取專案中的 AGENTS.md,因此可以把與專案相關的固定規則放在這裡,例如:
# AGENTS.md
## Project Rules
- Use Traditional Chinese when writing user-facing documentation.
- Do not modify database schema unless explicitly requested.
- Before changing code, inspect the existing architecture.
- Prefer small, reviewable changes.
- When writing WordPress articles, use the wordpress-seo-writer skill.
而真正的 Skill 內容則可以保留在專案目錄中:
project/
├── AGENTS.md
├── skills/
│ └── wordpress-seo-writer/
│ ├── SKILL.md
│ ├── references/
│ ├── examples/
│ └── scripts/
這樣做的好處是:
AGENTS.md 負責專案整體規則
SKILL.md 負責特定任務流程
references/ 保存知識與格式
scripts/ 保存可重複使用的工具
Codex 使用 Skill 的建議方式
如果 Skill 是用來處理開發工作,例如 Code Review、安全檢查、部署檢查,建議把 Skill 寫得更像工程 SOP。
例如:
# Code Review Security Skill
Use this skill when reviewing code changes for security, maintainability, and deployment risks.
## Review Checklist
1. Authentication and authorization
2. Input validation
3. SQL injection risk
4. Secrets and environment variables
5. File upload handling
6. Error handling
7. Logging and privacy
8. Deployment risk
## Output Format
Return the review in this format:
# Code Review Report
## Summary
## Critical Issues
## Medium Issues
## Low Risk Suggestions
## Recommended Patch
## Test Plan
然後在 AGENTS.md 裡加入:
## Skills
When the task involves security review, load:
skills/code-review-security/SKILL.md
這樣 Codex 在處理程式碼任務時,就可以依照固定流程執行,而不是每次都靠臨時 prompt。
Claude Skill、Hermes Agent、Codex 的對應關係
Skill 內容 Claude Code Hermes Agent Codex 任務說明 SKILL.md description manifest.json description AGENTS.md 或 Skill description 操作流程 SKILL.md system prompt / task prompt AGENTS.md / Skill 參考資料 references/ knowledge base / RAG project docs / references/ 腳本工具 scripts/ tools / function calling scripts / shell tools 輸出格式 SKILL.md response schema AGENTS.md / task instruction 測試案例 examples/ evaluation set test prompts / eval cases
移植時最容易出問題的地方
1. Skill 觸發條件不清楚
如果 description 寫得太模糊,Agent 不知道什麼時候該使用。
不建議:
建議:
當使用者要求撰寫 WordPress SEO 部落格文章,且需要標題、標籤、中繼描述與繁體中文內容時,使用此 Skill。
2. 原本依賴 Claude 的功能,其他系統沒有
有些 Skill 可能假設 Claude Code 可以讀檔、執行 script 或打包 .skill。 移植到其他系統時,要確認目標平台是否支援:
讀取本地檔案
執行 shell 指令
呼叫 Python 腳本
使用 MCP server
使用 function calling
存取 Git repo
存取外部 API
如果不支援,就要改成純文字流程,或另外做工具橋接。
3. references 太大,模型上下文放不下
如果參考文件很多,不建議一次全部塞進 prompt。 比較好的方式是:
1. 先用 Skill description 判斷要不要使用
2. 再根據任務讀取必要 references
3. 只載入與當前任務相關的段落
這樣可以避免上下文太長,也能提升回答品質。
4. 腳本路徑與執行環境不同
例如你在 Claude Code 裡用的是:
但移植到 Hermes Agent 的 Docker 環境後,可能要改成:
python /app/skills/wordpress-seo-writer/scripts/check.py
因此建議在 manifest.json 中明確寫出腳本路徑、執行方式與依賴套件。
建議:把 Skill 設計成可攜式能力包
如果你一開始就希望 Skill 可以移植到 Claude Code、Hermes Agent、Codex 或其他 Agent 系統,建議遵守以下原則:
1. SKILL.md 不要寫死特定平台專用語法
2. 把平台相關設定放到 adapters/ 目錄
3. 把核心流程寫在 core.md
4. 把範例輸入輸出放到 examples/
5. 把工具設定放到 manifest.json
可以設計成:
portable-skill/
├── core.md
├── SKILL.md
├── manifest.json
├── adapters/
│ ├── claude-code.md
│ ├── hermes-agent.md
│ └── codex-agents.md
├── references/
├── examples/
└── scripts/
其中:
core.md:保存跨平台共用的核心流程
SKILL.md:給 Claude Code 使用
manifest.json:給自建 Agent 系統使用
adapters/claude-code.md:Claude Code 專用說明
adapters/hermes-agent.md:Hermes Agent 專用說明
adapters/codex-agents.md:Codex 專用說明
這樣同一個 Skill 就不會被綁死在單一平台上。
移植檢查清單
在把 Skill 移到其他 Agent 系統前,可以用這份清單檢查:
□ Skill 的用途是否明確?
□ description 是否能讓 Agent 判斷何時使用?
□ 輸入格式是否定義清楚?
□ 輸出格式是否固定?
□ 是否有 examples?
□ 是否有 references?
□ references 是否可以被目標系統讀取?
□ scripts 是否能在目標環境執行?
□ 是否需要 API key 或環境變數?
□ 是否有測試案例?
□ 是否有平台專用 adapter?
□ 是否避免把敏感資訊寫進 Skill?
Skill 應該被設計成 Agent 的可攜式 SOP
skill-creator 產生的 Skill,最好不要只當成 Claude Code 的專用檔案。 更好的做法,是把它設計成一個「可攜式 AI 工作流程」。
Claude Code 可以使用 SKILL.md。 Hermes Agent 可以使用 manifest.json、references/ 與自訂 router。 Codex 可以透過 AGENTS.md、專案規則與 Skill 資料夾來載入任務流程。
只要核心流程設計清楚,Skill 就可以成為跨 Agent 系統共用的能力包,讓同一套工作方法在不同 AI 工具之間延續使用。
近期留言