by Rain Chu | 9 月 28, 2026 | AI , 影片製作
FaceFusion 的價值,是把換臉、人臉修復、遮罩與影片輸出放在同一套本地工具裡,可以控制素材與處理流程,也能逐項調整效果。但想讓成品自然,關鍵通常不是把所有增強功能打開,而是先選對素材、選對要處理的人,再修正最明顯的問題。
這篇從第一次安裝與圖片換臉開始,接著處理多人畫面、側臉穿幫、影片閃爍及音源錯誤,最後說明如何透過 Cpolar 遠端操作。
先用自己的照片,或已取得同意的素材練習,做出一小段穩定成果,再擴大到整支影片。
FaceFusion 是什麼?換臉、修臉與換頭先分清楚
FaceFusion 是一套可在本機執行的人臉處理平台,支援圖片與影片,它不是單一換臉模型,而是把不同模型與處理器整合起來,讓你依需求選擇換臉、表情還原、人臉增強、畫面增強或唇形同步。
最容易搞混的是「換臉」與「換整個頭部」,一般 face_swapper 主要替換臉部身份特徵,不應預期它會把頭髮、耳環、整個頭型與所有化妝細節一起重建,若目標是改髮型或重做角色造型,通常還需要其他影像編輯步驟,可以搭配多圖參考與圖像編輯工作流 理解不同工具的分工。
如果需求偏向即時鏡頭,而非事後處理影片,也可比較站內的Deep Live Cam 即時換臉介紹
下載前官方專案
官方原始碼位於 facefusion/facefusion ,可自行下載安裝,官方也提供付費的 Windows 與 macOS 安裝器,協助處理環境設定。
本地安裝:先把環境與推論後端配好
手動安裝需要 Git、Conda 與 FFmpeg。官方安裝文件 分別提供 Windows、macOS 與 Linux 的準備方式。先完成所用平台的環境與加速器設定,再建立獨立環境,避免與其他 AI 工具的套件互相影響。
conda init --all
conda create --name facefusion python=3.12 pip=25.0
conda activate facefusion
git clone https://github.com/facefusion/facefusion
cd facefusion
接著只選一種符合環境的安裝方式。CPU 或 macOS CoreML 路徑使用 default,已備妥對應 CUDA 環境的 NVIDIA 電腦可依官方範例選 cuda@12。Windows DirectML、Linux MIGraphX 與 OpenVINO 則各有對應選項,請按平台文件確認支援條件。
# CPU 或 macOS 路徑
python install.py default
# NVIDIA CUDA 路徑,擇一使用
python install.py cuda@12
完成後重新啟用環境,再啟動操作頁面。
conda deactivate
conda activate facefusion
python facefusion.py run --open-browser
較舊教學常出現 python install.py --onnxruntime cuda,但官方從 3.7.0 起改用位置參數,後續也區分 CUDA 版本。
遇到參數無法識別時,先執行 python install.py --help,對照目前安裝的程式,不要把不同年代的指令混在一起,更新紀錄 可用來追查這類差異。
啟動成功後,依終端機顯示的本機網址開啟介面,常見範例是 http://127.0.0.1:7860。
首次選用模型可能需要下載檔案,預覽暫時沒有結果時,先看下載與載入紀錄。
顯示記憶體與速度:先跑通,再追求高畫質
官方 FAQ 把 8GB 顯示記憶體列為最低建議,並表示 12GB 起通常較合適。
推論後端應依硬體與已安裝套件選擇,NVIDIA 可用 CUDA,Apple Silicon 可確認 CoreML,其他平台則視支援情況選擇 DirectML、MIGraphX 等,CPU 可以作為排錯與基本測試路徑,但不代表長影片處理會很快。Execution 設定 列出了後端與執行緒選項。
不要只因顯示記憶體較大,就直接把執行緒拉高,比較可靠的方式是固定一小段素材,先記錄預設值的耗時,再只改一個設定。速度沒有改善,或記憶體開始吃緊,就回到原本設定。
第一次換臉:只開必要功能,先完成一張圖片
1. 放對 Source 與 Target
Source 是提供臉部身份的來源照片,Target 是要被修改的圖片或影片。初次練習選一張光線均勻、五官清楚、沒有被頭髮或手遮住的正面照,搭配只有一個人的目標圖片。先避免大幅側轉、模糊與極端表情,較容易判斷是哪個環節出了問題。
2. 先保留 face_swapper
第一次只啟用換臉需要的 face_swapper,先確認來源臉與目標臉都能被辨識,不要一開始就同時啟用唇形同步、人臉增強與整幅畫面增強,否則一旦失敗,很難看出是哪個處理器造成的。
3. 先預覽,再增加修復
先看臉部位置是否正確,再看身份相似度、嘴部、眼睛、下巴與髮際線。若換對人但細節不足,再加 face_enhancer。frame_enhancer 處理的是整幅畫面,會增加計算量,並非每次換臉都必須開啟。過強的修復也可能讓皮膚變得過度平滑,需要保留原始版本比較。
模型怎麼選?用同一段素材比較最有用
官方 Face Swapper 文件 列有 HyperSwap、GHOST、INSwapper、SimSwap 等選項。
可以先用目前版本的預設模型做基準,再換另一個模型,觀察身份相似度、表情保留、輪廓接合與連續畫面的穩定度。 Pixel Boost 是換臉處理的解析度選項,也不等於整支影片直接升級成高品質 4K。調高前先確認它是否真的改善臉部細節,以及增加多少處理時間。
多人畫面與遮擋:先決定處理誰,再決定處理哪裡
多人同框時,先使用參考臉方式指定目標人物,並檢查不同時間點是否仍選到同一個人。
Face Selector 控制人物選擇與參考匹配,模型本身並不能代替這個步驟。人物交錯、遠近變化或離開畫面再出現,都值得單獨檢查。
遮罩則決定臉部哪些位置參與合成,Face Masker 提供 box、occlusion、area 與 region 等方式,遇到手、眼鏡或頭髮擋住臉,可以先測試遮擋遮罩,並檢查嘴部、下巴與髮際線的邊界。模糊邊緣只能改善接合,無法補回素材中根本看不到的臉部資訊。
檢查影片時,不只停在最好看的一格,應挑出正面、轉頭、張嘴、遮擋與人物交錯的片段,再連續播放,新版追蹤功能可協助補足部分漏偵測,但仍要逐段確認,不能當成「完全不閃爍」的保證。
一直要求選擇音源檔?先檢查 lip_syncer
單純把照片中的臉換到影片上,不代表你一定要另外提供音訊,如果啟動後出現「請選擇音源檔案」,先看是不是同時勾選了 lip_syncer。這個處理器是讓嘴形配合音訊,與基本換臉不同。
本次核對官方 lip_syncer 程式 ,它在前置檢查時確實要求來源檔中有音訊,若只要換臉,先取消 lip_syncer,再用 face_swapper 測試。若需要重新配音與對嘴,才加入合適的音源,並另外驗收聲畫同步。
用 Cpolar 遠端操作:運算仍在家中的電腦
FaceFusion 在本機跑穩後,才需要考慮遠端入口,Cpolar 可以把本地 Web 服務透過隧道提供給外部裝置,手機瀏覽器只是操作介面,真正的換臉運算仍由原本的電腦執行,電腦休眠、FaceFusion 關閉或隧道中斷,都會讓遠端入口失效。
基本順序是安裝並登入 Cpolar,在本機管理頁建立 HTTP 隧道,把本地地址填成 FaceFusion 實際使用的連接埠,再從在線隧道列表取得網址,常見的 7860 是 FaceFusion 服務範例,9200 則是 Cpolar 管理頁,兩者用途不同,不要把管理頁當成要分享的換臉入口。
固定網址與登入保護也要分開設定,依Cpolar 官方文件 ,保留固定二級子網域需要基礎方案或以上,不能把它寫成所有免費帳號都能永久保留,官方也提供 HTTP Basic Auth。對外使用時,應使用 HTTPS 入口與存取驗證,並先測試沒有登入的人是否確實無法進入。
站內的本地 AI 遠端連線教學 可協助理解「服務在哪台機器跑」與「從哪個入口連入」的差別。
免費取得,不代表每個模型都適合商業專案
FaceFusion 官方標示軟體採 OpenRAIL-AS,模型則各有授權,官方授權清單 目前把 HyperSwap 列為 ResearchRAIL,INSwapper 與 AlphaFace 列為 Non-Commercial,GHOST 列為 Apache 2.0。這些是不同資產的標示,不能只看主程式名稱就推定整套流程可商用。
如果要用在客戶影片,請把實際使用的換臉、偵測、增強與其他模型一起列出,逐一核對條款及素材使用同意。某個換臉模型的授權較寬鬆,也不會自動涵蓋其他模型或照片中人物的使用權利。
常見問題
FaceFusion 可以免費使用嗎?
官方原始碼可自行取得與安裝,官方安裝器及部分服務另外收費。模型與其他資產仍有各自的授權條件。
FaceFusion 換臉會連髮型一起更換嗎?
一般 face_swapper 主要處理臉部身份,不應預期它會完整重建頭髮、頭型與飾品。換整個頭部通常需要其他編輯流程。
為什麼影片換臉要求選擇音源?
先檢查是否啟用了 lip_syncer。純換臉可先取消它,只保留 face_swapper 測試,需要對嘴時才加入音訊。
FaceFusion 側臉穿幫或閃爍怎麼辦?
先比較來源與目標的角度,再檢查人物選擇、遮擋遮罩與不同模型。用轉頭、張嘴與遮擋片段測試,不能只驗收單張預覽。
手機能透過 Cpolar 使用 FaceFusion 嗎?
可以透過瀏覽器操作已建立的遠端入口,但運算仍在原本電腦上。需要維持主機與服務在線,並設定存取驗證。
先把一小段做好,再把流程擴大
FaceFusion 的可調空間很大,也因此更需要固定測試方式。先用單張圖片確認身份與輪廓,再挑包含轉頭或遮擋的短片段驗收。只有當模型、遮罩與輸出設定穩定後,再加入增強、批次處理與遠端入口。
當你開始串接更多素材整理與輸出步驟,也可參考本地 AI 影片工作流的部署方式 。真正省時間的,是知道每個步驟為什麼存在,以及出了問題要回頭檢查哪裡。
by Rain Chu | 6 月 18, 2026 | AI , skills
在網站製作的世界裡,最痛苦的往往不是「會不會架 WordPress」,而是「怎麼把網站做得像專業品牌」。
很多人可以安裝主題、套版、放圖片、改文字,但真正卡住的地方通常是:
版面不夠高級、配色不協調、按鈕不知道放哪裡、手機版跑版、Landing Page 沒有轉換力、Dashboard 看起來不像專業產品。
這時候,UIUX Pro Max Skill 就像是一位專門站在你旁邊的前端與 UI/UX 顧問。你不需要一開始就懂設計系統、字體比例、色彩心理學、Tailwind、React、Next.js 或 shadcn/ui,只要用自然語言描述你想要的網站,它就能協助 AI Coding Assistant 產生更像專業前端設計師規劃出來的介面。
官方網站:https://ui-ux-pro-max-skill.nextlevelbuilder.io/
GitHub 專案:https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
下載與安裝:https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/releases
UIUX Pro Max 是什麼?
UIUX Pro Max,全名通常會看到 ui-ux-pro-max-skill ,是一個提供 AI 助手使用的 UI/UX 設計技能包。它的核心概念很簡單:
讓 AI 不只是「會寫前端程式」,而是更懂「什麼樣的前端才像專業產品」。
一般 AI 寫前端時,很容易產生一種常見問題:功能有了,但畫面普通;元件有了,但缺乏層次;版面能跑,但沒有品牌感。
UIUX Pro Max 則補上這塊空白。它把 UI 風格、色票、字體搭配、圖表類型、UX 規則、設計系統與不同技術框架的實作建議整理成一套可被 AI 助手調用的知識庫。
你可以把它想像成:
給 Claude Code、Cursor、Codex CLI、Windsurf 等工具使用的 UI/UX 專家包
給前端開發者使用的設計系統產生器
給不懂設計的創業者、站長、行銷人員使用的網站美感加速器
給 WordPress 專案使用的外觀與互動規劃參考工具
它不是單純的 WordPress 外掛,而是可以協助你在製作 WordPress 網站、Landing Page、SaaS 後台、會員系統、形象網站或行銷頁時,快速產生更專業的前端設計方向。
特色
1. 用自然語言產生 UI/UX 設計方向
你不需要一開始就寫完整規格,只要描述你的需求,例如:
「幫我設計一個牙醫診所形象網站,要乾淨、可信任、有預約按鈕。」
「我要一個 WordPress 課程銷售頁,風格要像高級教育平台。」
「幫我做一個 SaaS 後台 Dashboard,要有現代感、卡片式資料區塊、RWD。」
AI 搭配 UIUX Pro Max 後,就能更有方向地產生版面、色彩、字體、元件與視覺層次。
2. 自動生成設計系統
UIUX Pro Max 的重點之一,是能依據專案需求產生設計系統。
這對 WordPress 網站很重要,因為很多網站最後看起來不專業,不是因為圖片不夠漂亮,而是缺乏一致性。
設計系統可以包含:
主色與輔色
字體搭配
標題大小
內文行距
按鈕樣式
卡片樣式
表單樣式
間距規則
RWD 斷點
常用元件規範
如果你是用 WordPress + Elementor、Bricks、Block Editor、GeneratePress、Astra 或自製主題,這些設計系統都可以成為你調整網站外觀時的重要依據。
3. 適合 WordPress 外掛與主題開發
雖然 UIUX Pro Max 不是傳統意義上的 WordPress 外掛,但它非常適合拿來輔助 WordPress 開發。
例如你正在開發:
WordPress 企業形象網站
WooCommerce 商品頁
線上課程銷售頁
會員中心
後台管理介面
預約系統
AI 工具網站
部落格首頁
Landing Page
WordPress 外掛設定頁
你可以請 AI 搭配 UIUX Pro Max 先產生 UI 規劃,再把設計轉換成 HTML、Tailwind、React、Next.js、PHP Blade、甚至 WordPress 區塊設計邏輯。
4. 支援多種前端技術棧
UIUX Pro Max 不只適合單一框架,它的 GitHub README 中列出多種支援方向,包括 HTML + Tailwind、React、Next.js、shadcn/ui、Vue、Nuxt、Angular、Svelte、Astro、SwiftUI、Jetpack Compose、React Native、Flutter 等。
對 WordPress 使用者來說,最實用的組合通常會是:
HTML + Tailwind
React
Next.js
shadcn/ui
PHP / Laravel Blade 概念
WordPress 區塊與前端樣式規劃
如果你的 WordPress 網站有自製外掛、客製後台、Headless WordPress 或 Next.js 前台,UIUX Pro Max 會更有幫助。
5. 做出不「凡」的網站
多數人不是專業設計師,也不是全職前端工程師。
你可能是創業者、老師、站長、接案者、行銷人、公司內部資訊人員,甚至只是想把自己的 WordPress 網站改得更好看。
UIUX Pro Max 的價值在於:它把許多專業設計師腦中的判斷,變成 AI 可以引用的規則與資料庫。你不必從零開始學完 UI/UX,也能讓 AI 提供更接近專業前端顧問的建議。
關鍵指令
以下是常用指令,可以依照你的 AI 工具環境選擇。
Claude Code Marketplace 安裝方式
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
CLI 安裝方式
npm install -g uipro-cli
cd /path/to/your/project
uipro init --ai claude
安裝到其他 AI 助手
uipro init --ai cursor
uipro init --ai windsurf
uipro init --ai copilot
uipro init --ai codex
uipro init --ai gemini
uipro init --ai opencode
uipro init --ai all
全域安裝
uipro init --ai claude --global
uipro init --ai cursor --global
更新與移除
uipro versions
uipro update
uipro uninstall
使用範例
Build a landing page for my SaaS product
Create a dashboard for healthcare analytics
Design a portfolio website with dark mode
Make a mobile app UI for e-commerce
Build a fintech banking app with dark theme
直接呼叫 Skill
/ui-ux-pro-max Build a landing page for my SaaS product
使用流程圖
WordPress 使用情境範例
情境一:幫企業形象網站重新設計首頁
你可以這樣下指令:
請幫我重新設計一個 WordPress 企業形象網站首頁。
產業是 B2B 軟體服務,目標客戶是中小企業老闆。
風格要專業、可信任、不要太科技黑。
請提供首頁區塊架構、主色、字體、CTA 按鈕、RWD 注意事項。
AI 搭配 UIUX Pro Max 後,會比較容易產生完整的首頁架構,例如 Hero、痛點、服務特色、案例、流程、FAQ、CTA 等,而不是只給你一個普通的套版。
情境二:幫 WooCommerce 商品頁提高轉換率
請幫我優化 WooCommerce 商品頁 UI/UX。
商品是高單價健康設備。
目標是增加詢問與預約體驗。
請設計商品頁資訊層級、信任元素、CTA 區塊與手機版版面。
這類任務不只是美化,而是結合轉換率、資訊層級與使用者行為。UIUX Pro Max 很適合用在這種「不只要好看,也要有效」的頁面。
情境三:設計 WordPress 外掛設定頁
請幫我設計一個 WordPress 外掛設定頁。
外掛功能是 AI 自動批改作業。
需要包含 API Key 設定、模型選擇、批改規則、通知設定與儲存按鈕。
請提供乾淨、專業、適合老師使用的 UI。
如果你正在開發 WordPress 外掛,後台設定頁常常會被忽略,但它其實非常影響使用體驗。UIUX Pro Max 可以協助你把設定頁做得更清楚、有層次,也更接近 SaaS 產品的質感。
為什麼推薦 UIUX Pro Max?
1. 降低設計門檻
不是每個人都請得起專業 UI 設計師,也不是每個專案都有時間走完整設計流程。UIUX Pro Max 可以讓 AI 幫你補上第一版設計判斷。
2. 節省溝通成本
過去做網站常常要反覆跟設計師或前端工程師溝通:「再高級一點」、「不要那麼像模板」、「手機版怪怪的」。現在你可以直接把品牌、情境、目標客戶、色調偏好告訴 AI,讓它先產出一版更接近方向的方案。
3. 適合快速做 MVP
如果你正在做新產品、SaaS、AI 工具、課程平台、會員網站或接案展示頁,UIUX Pro Max 很適合用來快速產生第一版專業視覺。
4. 可延伸到實際程式碼
它不是只能給概念,也能配合 AI Coding Assistant 產生前端程式碼、元件設計與樣式規則。對工程師來說,這比單純看設計靈感網站更直接。
使用時要注意什麼?
1. 它不是魔法,仍然需要你提供明確需求
你給的需求越清楚,產出的設計越準。
建議至少提供:
產業類型
目標客戶
網站目的
喜歡或不喜歡的風格
是否要深色模式
是否需要手機優先
使用的技術棧
是否要套用到 WordPress
是否偏向銷售、品牌、教學或後台管理
2. 不要只說「幫我做漂亮一點」
比較好的說法是:
請幫我把這個 WordPress 首頁改成更像 B2B SaaS 的專業風格。
目標客戶是企業主管。
請避免卡通感與過度漸層。
主色希望是深藍與白色,CTA 使用亮色。
請提供 Hero、功能、案例、價格與 FAQ 區塊。
這樣 AI 才會知道「漂亮」的方向是什麼。
3. 最後仍要人工檢查
AI 產出的設計很適合當第一版,但正式上線前仍然建議檢查:
手機版是否正常
文字是否符合品牌語氣
色彩對比是否足夠
按鈕是否明顯
表單是否容易填寫
SEO 標題是否正確
WordPress 主題是否相容
外掛是否造成樣式衝突
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 | 4 月 15, 2026 | AI , claude , 模型
從 MCP failed 到 connected,一步步解決 Windows 上的 Channels 整合問題
April 2026·Claude Code v2.1.109·適用平台:Windows
目錄
前言:Claude Code Channels 是什麼
前置需求 claude.ai 登入、Bot 設定
安裝與啟動 plugin install、–channels 旗標
常見錯誤與解法 Auth 衝突、MCP failed、Bun
確認成功運作
已知限制與現況
前言:Claude Code Channels 是什麼
Claude Code Channels 是 Anthropic 在 2026 年 3 月推出的實驗性功能,讓你可以透過 Telegram(或 Discord)把訊息推送進正在執行的 Claude Code session。
實際的應用場景:你在外出時用手機傳一句「跑一下測試,告訴我有沒有失敗」,你的電腦上的 Claude Code 就會收到、執行,然後把結果回傳到 Telegram。
注意Channels 目前仍是 Research Preview(實驗性功能),Windows 上有已知的穩定性問題。本文記錄的是截至 v2.1.109 的實際狀況。
前置需求
Claude Code 已安裝且版本 ≥ v2.1.109 用 npm update -g @anthropic-ai/claude-code 更新
使用 claude.ai 帳號登入(Pro 或 Max) Channels 不支援純 API Key 認證,必須用 claude.ai 帳號
在 Telegram 建立 Bot(透過 @BotFather) 取得形如 123456789:AAHfiqks... 的 Bot Token
安裝 Bun 執行環境(Windows 必須) Telegram plugin 使用 Bun 執行,這是最常被忽略的步驟
安裝 Bun(Windows 必做)
這是 Windows 上最容易卡關的地方。Telegram plugin 的 MCP server 以 Bun 執行,沒有 Bun 就會直接顯示 MCP · ✗ failed。
在 PowerShell 中執行:
powershell -c "irm bun.sh/install.ps1 | iex"
安裝完後關閉並重新開啟 PowerShell (讓 PATH 生效),確認安裝成功:
bun --version
# 應該輸出版本號,例如:1.x.x
解決 Auth 衝突
若啟動時看到這個警告:
⚠ Auth conflict: Both a token (claude.ai) and an API key
(/login managed key) are set.
這代表同時存在兩種認證方式。Channels 功能只支援 claude.ai 登入 ,需要清除衝突:
登出後重新用 claude.ai 帳號登入,確認登入後只有一種認證方式存在。
安裝與設定 Telegram Plugin
啟動 Claude Code,在對話中執行以下指令:
/plugin install telegram@claude-plugins-official
安裝完成後設定 Bot Token:
/telegram:configure <你的 Bot Token>
設定存取權限(建議啟動後先用 pairing 模式,再切換成 allowlist):
啟動 Channels
claude --channels plugin:telegram@claude-plugins-official
啟動後會看到:
Listening for channel messages from: plugin:telegram@claude-plugins-official
Experimental · inbound messages will be pushed into this session
驗證是否成功
在 Claude Code 裡執行 /plugin list ,確認顯示:
telegram Plugin · claude-plugins-official · ✔ enabled
└ telegram MCP · ✔ connected ← 這行是關鍵!
成功標誌看到 telegram MCP · ✔ connected 就代表設定完成,可以去 Telegram 傳訊息測試了。
常見錯誤排查
telegram MCP · ✗ failed
原因: Bun 未安裝或不在 PATH 中。解法: 安裝 Bun(irm bun.sh/install.ps1 | iex),重新開啟 PowerShell 後再試。
Auth conflict 警告
原因: 同時存在 claude.ai token 和 API key。解法: 執行 claude /logout 清除衝突,選擇一種登入方式。Channels 需要 claude.ai 登入。
傳訊息沒有回應(MCP 顯示 connected)
原因: 你的 Telegram 使用者 ID 不在 allowlist,或是 pairing 尚未完成。解法: 執行 /telegram:access 確認存取設定,或重新執行 pairing 流程。
已知限制(截至 v2.1.109)
這個功能仍在快速迭代,以下是目前的已知狀況:
Channels 只在 session 開啟時運作,關掉 Claude Code 就收不到訊息
如需長時間監聽,建議搭配 tmux 或讓終端機持續開著
Windows 上的穩定性比 macOS/Linux 差,偶爾需要重啟
目前是 Research Preview,API 隨時可能變更
參考資訊
https://code.claude.com/docs/zh-TW/channels
第三方 telegram
近期留言