必需外掛程式安裝：superpowers 與 ui-ux-pro-max | AI App Factory 教學

學完你能做什麼

檢查 superpowers 和 ui-ux-pro-max 外掛程式是否已安裝
手動安裝這兩個必需外掛程式（如果自動安裝失敗）
驗證外掛程式是否正確啟用
理解為什麼這兩個外掛程式是流水線執行的前提條件
排查外掛程式安裝失敗的常見問題

你現在的困境

執行 Factory 流水線時，你可能會遇到：

Bootstrap 階段失敗：提示「未使用 superpowers:brainstorm 技能」
UI 階段失敗：提示「未使用 ui-ux-pro-max 技能」
自動安裝失敗：factory init 時外掛程式安裝出現錯誤
外掛程式衝突：已有同名外掛程式但版本不對
權限問題：外掛程式安裝後未被正確啟用

其實，Factory 在初始化時會自動嘗試安裝這兩個外掛程式，但如果失敗，你需要手動處理。

什麼時候用這一招

當出現以下情況時，需要手動安裝外掛程式：

factory init 時提示外掛程式安裝失敗
Bootstrap 或 UI 階段偵測到未使用必需技能
首次使用 Factory，確保流水線能正常執行
外掛程式版本過舊，需要重新安裝

為什麼需要這兩個外掛程式

Factory 的流水線依賴兩個關鍵的 Claude Code 外掛程式：

外掛程式	用途	流水線階段	提供的技能
superpowers	深入挖掘產品想法	Bootstrap	`superpowers:brainstorm` - 系統化腦力激盪，分析問題、使用者、價值、假設
ui-ux-pro-max	生成專業設計系統	UI	`ui-ux-pro-max` - 67 種樣式、96 種調色盤、100 條產業規則

強制要求

根據 agents/orchestrator.checkpoint.md 的定義，這兩個外掛程式是強制要求：

Bootstrap 階段：必須使用 superpowers:brainstorm 技能，否則拒絕產物
UI 階段：必須使用 ui-ux-pro-max 技能，否則拒絕產物

🎒 開始前的準備

在開始之前，請確保：

[ ] 已安裝 Claude CLI（claude --version 可用）
[ ] 已完成 factory init 初始化專案
[ ] 已設定 Claude Code 權限（參考 Claude Code 整合指南）
[ ] 網路連線正常（需要存取 GitHub 外掛程式市集）

核心思路

外掛程式安裝採用檢查→加入市集→安裝→驗證四步流程：

檢查：查看外掛程式是否已安裝
加入市集：將外掛程式儲存庫加入 Claude Code 外掛程式市集
安裝：執行安裝指令
驗證：確認外掛程式已啟用

Factory 的自動安裝指令碼（cli/scripts/check-and-install-*.js）會自動執行這些步驟，但你需要了解手動方法以應對失敗情況。

跟我做

第 1 步：檢查外掛程式狀態

為什麼 先確認是否已安裝，避免重複操作。

開啟終端機，在專案根目錄執行：

bash

claude plugin list

你應該看到：已安裝外掛程式的列表，如果包含以下內容則說明已安裝：

✅ superpowers (enabled)
✅ ui-ux-pro-max (enabled)

如果看不到這兩個外掛程式，或顯示 disabled，則需要繼續下面的步驟。

factory init 的自動安裝

factory init 指令會自動執行外掛程式安裝檢查（第 360-392 行的 init.js）。如果成功，你會看到：

📦 Installing superpowers plugin... ✓
📦 Installing ui-ux-pro-max-skill plugin... ✓
✅ Plugins installed!

第 2 步：安裝 superpowers 外掛程式

為什麼 Bootstrap 階段需要使用 superpowers:brainstorm 技能進行腦力激盪。

加入外掛程式市集

bash

claude plugin marketplace add obra/superpowers-marketplace

你應該看到：

✅ Plugin marketplace added successfully

市集加入失敗

如果提示「外掛程式市集已存在」，可以忽略，繼續執行安裝步驟。

安裝外掛程式

bash

claude plugin install superpowers@superpowers-marketplace

你應該看到：

✅ Plugin installed successfully

驗證安裝

bash

claude plugin list

你應該看到：列表中包含 superpowers (enabled)。

第 3 步：安裝 ui-ux-pro-max 外掛程式

為什麼 UI 階段需要使用 ui-ux-pro-max 技能生成設計系統。

加入外掛程式市集

bash

claude plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill

你應該看到：

✅ Plugin marketplace added successfully

安裝外掛程式

bash

claude plugin install ui-ux-pro-max@ui-ux-pro-max-skill

你應該看到：

✅ Plugin installed successfully

驗證安裝

bash

claude plugin list

你應該看到：列表中包含 ui-ux-pro-max (enabled)。

第 4 步：驗證兩個外掛程式都正常運作

為什麼 確保流水線可以正常呼叫這兩個外掛程式的技能。

驗證 superpowers

在 Claude Code 中執行：

請使用 superpowers:brainstorm 技能幫我分析以下產品想法：[你的想法]

你應該看到：Claude 開始使用 brainstorm 技能，系統化地分析問題、使用者、價值和假設。

驗證 ui-ux-pro-max

在 Claude Code 中執行：

請使用 ui-ux-pro-max 技能為我的應用程式設計一個配色方案

你應該看到：Claude 回傳一個包含多種設計選項的專業配色建議。

檢查點 ✅

完成上述步驟後，確認以下幾點：

[ ] 執行 claude plugin list 能看到兩個外掛程式都標記為 enabled
[ ] 在 Claude Code 中可以呼叫 superpowers:brainstorm 技能
[ ] 在 Claude Code 中可以呼叫 ui-ux-pro-max 技能
[ ] 執行 factory run 時不再提示缺少外掛程式

踩坑提醒

❌ 外掛程式已安裝但未啟用

現象：claude plugin list 顯示外掛程式存在但沒有 enabled 標記。

解決方法：重新執行安裝指令：

bash

claude plugin install <外掛程式 ID>

❌ 權限被阻止

現象：提示「Permission denied: Skill(superpowers:brainstorming)」

原因：Claude Code 的權限設定中未包含 Skill 權限。

解決方法：檢查 .claude/settings.local.json 中是否包含：

json

{
  "permissions": [
    "Skill(superpowers:brainstorming)",
    "Skill(ui-ux-pro-max)"
  ]
}

完整權限設定

這是最小權限設定範例。Factory 的 init 指令會自動生成完整的權限設定檔（包括 Skill(superpowers:brainstorm) 和其他必要權限），通常不需要手動編輯。

如果需要重新生成權限設定，可以在專案根目錄執行：

bash

factory init --force-permissions

參考 Claude Code 整合指南重新生成權限設定。

❌ 市集加入失敗

現象：claude plugin marketplace add 失敗，提示「not found」或網路錯誤。

解決方法：

檢查網路連線
確認 Claude CLI 版本最新：npm update -g @anthropic-ai/claude-code
嘗試直接安裝：跳過市集加入，直接執行 claude plugin install <外掛程式 ID>

❌ 外掛程式版本衝突

現象：已安裝同名外掛程式，但版本不對導致流水線失敗。

解決方法：

bash

# 解除安裝舊版本
claude plugin uninstall <外掛程式名稱>

# 重新安裝
claude plugin install <外掛程式 ID>

❌ Windows 路徑問題

現象：在 Windows 上執行指令碼時提示「命令未找到」。

解決方法：

使用 Node.js 直接執行安裝指令碼：

bash

node cli/scripts/check-and-install-superpowers.js
node cli/scripts/check-and-install-ui-skill.js

自動安裝失敗的應對

如果 factory init 時的自動安裝失敗，你可以：

查看錯誤資訊：終端機會顯示具體失敗原因
手動安裝：按照上面的步驟手動安裝兩個外掛程式
重新執行：factory run 會偵測外掛程式狀態，如果已安裝則繼續流水線

不影響流水線啟動

即使外掛程式安裝失敗，factory init 仍會完成初始化。你可以在後續手動安裝外掛程式，不影響後續操作。

外掛程式在流水線中的作用

Bootstrap 階段（必需 superpowers）

技能呼叫：superpowers:brainstorm
輸出：input/idea.md - 結構化的產品想法文件
驗證點：檢查 Agent 是否明確說明使用了該技能（orchestrator.checkpoint.md:60-70）

UI 階段（必需 ui-ux-pro-max）

技能呼叫：ui-ux-pro-max
輸出：artifacts/ui/ui.schema.yaml - 包含設計系統的 UI Schema
驗證點：檢查設計系統設定是否來自該技能（orchestrator.checkpoint.md:72-84）

本課小結

Factory 依賴兩個必需外掛程式：superpowers 和 ui-ux-pro-max
factory init 會自動嘗試安裝，但失敗時需要手動處理
外掛程式安裝流程：檢查→加入市集→安裝→驗證
確保兩個外掛程式都處於 enabled 狀態，並且權限設定正確
流水線的 Bootstrap 和 UI 階段會強制檢查這兩個外掛程式的使用情況

下一課預告

下一課我們學習 7 階段流水線概覽。
你會學到：
流水線的完整執行流程
每個階段的輸入輸出和職責
檢查點機制如何確保品質
如何從一個失敗的階段恢復

附錄：原始碼參考

點擊展開查看原始碼位置

更新時間：2026-01-29

功能	檔案路徑	行號
Superpowers 外掛程式檢查指令碼	`cli/scripts/check-and-install-superpowers.js`	1-208
UI/UX Pro Max 外掛程式檢查指令碼	`cli/scripts/check-and-install-ui-skill.js`	1-209
自動外掛程式安裝邏輯	`cli/commands/init.js`	360-392
Bootstrap 階段技能驗證	`agents/orchestrator.checkpoint.md`	60-70
UI 階段技能驗證	`agents/orchestrator.checkpoint.md`	72-84

關鍵常數：

PLUGIN_NAME = 'superpowers'：superpowers 外掛程式名稱
PLUGIN_ID = 'superpowers@superpowers-marketplace'：superpowers 完整 ID
PLUGIN_MARKETPLACE = 'obra/superpowers-marketplace'：外掛程式市集儲存庫
UI_PLUGIN_NAME = 'ui-ux-pro-max'：UI 外掛程式名稱
UI_PLUGIN_ID = 'ui-ux-pro-max@ui-ux-pro-max-skill'：UI 外掛程式完整 ID
UI_PLUGIN_MARKETPLACE = 'nextlevelbuilder/ui-ux-pro-max-skill'：UI 外掛程式市集儲存庫

關鍵函式：

isPluginInstalled()：檢查外掛程式是否已安裝（透過 claude plugin list 輸出）
addToMarketplace()：將外掛程式加入市集（claude plugin marketplace add）
installPlugin()：安裝外掛程式（claude plugin install）
verifyPlugin()：驗證外掛程式已安裝並啟用
main()：主函式，執行完整的檢查→加入→安裝→驗證流程

必需外掛程式安裝：superpowers 與 ui-ux-pro-max | AI App Factory 教學 ​

學完你能做什麼 ​

你現在的困境 ​

什麼時候用這一招 ​

為什麼需要這兩個外掛程式 ​

🎒 開始前的準備 ​

核心思路 ​

跟我做 ​

第 1 步：檢查外掛程式狀態 ​

第 2 步：安裝 superpowers 外掛程式 ​

加入外掛程式市集 ​

安裝外掛程式 ​

驗證安裝 ​

第 3 步：安裝 ui-ux-pro-max 外掛程式 ​

加入外掛程式市集 ​

安裝外掛程式 ​

驗證安裝 ​

第 4 步：驗證兩個外掛程式都正常運作 ​

驗證 superpowers ​

驗證 ui-ux-pro-max ​

檢查點 ✅ ​

踩坑提醒 ​

❌ 外掛程式已安裝但未啟用 ​

❌ 權限被阻止 ​

❌ 市集加入失敗 ​

❌ 外掛程式版本衝突 ​

❌ Windows 路徑問題 ​

自動安裝失敗的應對 ​

外掛程式在流水線中的作用 ​

Bootstrap 階段（必需 superpowers） ​

UI 階段（必需 ui-ux-pro-max） ​

本課小結 ​

下一課預告 ​

附錄：原始碼參考 ​

必需外掛程式安裝：superpowers 與 ui-ux-pro-max | AI App Factory 教學

學完你能做什麼

你現在的困境

什麼時候用這一招

為什麼需要這兩個外掛程式

🎒 開始前的準備

核心思路

跟我做

第 1 步：檢查外掛程式狀態

第 2 步：安裝 superpowers 外掛程式

加入外掛程式市集

安裝外掛程式

驗證安裝

第 3 步：安裝 ui-ux-pro-max 外掛程式

加入外掛程式市集

安裝外掛程式

驗證安裝

第 4 步：驗證兩個外掛程式都正常運作

驗證 superpowers

驗證 ui-ux-pro-max

檢查點 ✅

踩坑提醒

❌ 外掛程式已安裝但未啟用

❌ 權限被阻止

❌ 市集加入失敗

❌ 外掛程式版本衝突

❌ Windows 路徑問題

自動安裝失敗的應對

外掛程式在流水線中的作用

Bootstrap 階段（必需 superpowers）

UI 階段（必需 ui-ux-pro-max）

本課小結

下一課預告

附錄：原始碼參考