OpenCode 安裝 superpowers 完全攻略

更新時(shí)間：2026年04月22日 09:19:07 作者：一個(gè)便士

本文介紹了如何在maccode安裝超級(jí)編程技能superpowers,它讓AI遵循測(cè)試驅(qū)動(dòng)開發(fā)、代碼規(guī)范等工程流程,生成高質(zhì)量代碼,文章詳細(xì)講解了maccode安裝、驗(yàn)證、避坑等步驟,并提供了macos、linux、windows等平臺(tái)的安裝指南

OpenCode 安裝 superpowers 技能

軟件地址： https://github.com/obra/superpowers?tab=coc-ov-file

Superpowers 是 OpenCode 生態(tài)中最強(qiáng)大的工程化 AI 編程技能庫，能讓 AI 嚴(yán)格遵循 TDD（測(cè)試驅(qū)動(dòng)開發(fā)）、代碼規(guī)范、工程流程，輸出可直接上線的工業(yè)級(jí)代碼，徹底解決 AI 編碼 “堆屎山” 問題。本文提供 macOS/Linux/Windows 全平臺(tái)安裝、驗(yàn)證、使用、避坑 完整文檔，可直接發(fā)布。

一、Superpowers 核心介紹

1.1 是什么

定位：AI 編程「工程化規(guī)范引擎」，給 OpenCode 裝上14+ 專業(yè)開發(fā)技能
核心能力：TDD 測(cè)試驅(qū)動(dòng)、系統(tǒng)化調(diào)試、代碼審查、分支管理、并行代理、需求澄清
工作原理：通過插件注入系統(tǒng)提示 + 技能目錄鏈接，讓 AI 自動(dòng)遵守開發(fā)鐵律
適用場(chǎng)景：后端 / 前端 / 小程序 / 數(shù)據(jù)庫項(xiàng)目，追求零 BUG、可維護(hù)、工程規(guī)范的開發(fā)

1.2 技能清單（14 個(gè)核心）

表格

類別	技能	功能
?? 測(cè)試	test-driven-development	先寫測(cè)試→再寫代碼→重構(gòu)（RED-GREEN-REFACTOR）
	verification-before-completion	完成前必須提供驗(yàn)證證據(jù)
?? 調(diào)試	systematic-debugging	四階段調(diào)試：根因→分析→驗(yàn)證→修復(fù)
?? 協(xié)作	requesting-code-review	主動(dòng)發(fā)起代碼審查
	receiving-code-review	合理響應(yīng)審查意見
	finishing-a-development-branch	分支合并 / PR / 丟棄規(guī)范流程
	dispatching-parallel-agents	多任務(wù)并行代理調(diào)度
	brainstorming	需求澄清、蘇格拉底式對(duì)話
	writing-plans	生成精確開發(fā)計(jì)劃（文件路徑 + 代碼 + 驗(yàn)證）
	executing-plans	批量執(zhí)行開發(fā)計(jì)劃
	code-structure	項(xiàng)目結(jié)構(gòu)規(guī)范
	naming-conventions	命名規(guī)范
	error-handling	錯(cuò)誤處理規(guī)范
?? 元技能	using-superpowers	Superpowers 使用指南
	writing-skills	自定義技能開發(fā)

二、環(huán)境準(zhǔn)備（必看）

2.1 前提條件

已安裝 OpenCode.ai（最新版）
已安裝 Git（克隆倉庫用）
Windows：開啟 開發(fā)者模式 或 管理員權(quán)限（創(chuàng)建符號(hào)鏈接）

2.2 安裝方式（2 種）

方式 A（推薦?新版）：opencode.json 配置自動(dòng)安裝（1 行配置）
方式 B（兼容?舊版）：手動(dòng)克隆 + 符號(hào)鏈接（全平臺(tái)通用）

三、方式 A：自動(dòng)安裝（推薦?2026 最新）

3.1 步驟 1：編輯配置文件

找到 OpenCode 配置文件：

macOS/Linux：~/.config/opencode/opencode.json
Windows：%USERPROFILE%\.config\opencode\opencode.json

添加 plugin 字段（無則新增，有則追加）：

{
  "plugin": [
    "superpowers@git+https://github.com/obra/superpowers.git"
  ]
}

3.2 步驟 2：重啟 OpenCode

完全退出 OpenCode（進(jìn)程結(jié)束）
重新啟動(dòng) → 自動(dòng)下載、安裝、注冊(cè)所有技能

3.3 步驟 3：驗(yàn)證安裝

在 OpenCode 聊天框輸入：

Tell me about your superpowers

? 成功：返回 Superpowers 技能列表、功能說明? 失敗：重啟 OpenCode 或檢查配置文件格式

四、方式 B：手動(dòng)安裝（全平臺(tái)通用?舊版兼容）

4.1 macOS / Linux 手動(dòng)安裝

步驟 1：克隆 Superpowers 倉庫

# 克?。ㄒ汛嬖趧t更新）
if [ -d ~/.config/opencode/superpowers ]; then
  cd ~/.config/opencode/superpowers && git pull
else
  git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
fi

步驟 2：創(chuàng)建目錄（不存在則新建）

mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills

步驟 3：清理舊鏈接（避免沖突）

rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

步驟 4：創(chuàng)建符號(hào)鏈接（核心）

# 插件鏈接
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js
# 技能目錄鏈接
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers

步驟 5：重啟 OpenCode → 完成

4.2 Windows 手動(dòng)安裝（CMD/PowerShell）

步驟 1：克隆倉庫

git clone https://github.com/obra/superpowers.git %USERPROFILE%\.config\opencode\superpowers

步驟 2：創(chuàng)建目錄

mkdir "%USERPROFILE%\.config\opencode\plugins" 2>nul
mkdir "%USERPROFILE%\.config\opencode\skills" 2>nul

步驟 3：清理舊鏈接

del "%USERPROFILE%\.config\opencode\plugins\superpowers.js" 2>nul
rmdir "%USERPROFILE%\.config\opencode\skills\superpowers" 2>nul

步驟 4：創(chuàng)建鏈接（管理員權(quán)限）

# 插件鏈接
mklink "%USERPROFILE%\.config\opencode\plugins\superpowers.js" ^
"%USERPROFILE%\.config\opencode\superpowers\.opencode\plugins\superpowers.js"
# 技能目錄鏈接（ Junction，無需開發(fā)者模式）
mklink /J "%USERPROFILE%\.config\opencode\skills\superpowers" ^
"%USERPROFILE%\.config\opencode\superpowers\skills"

步驟 5：重啟 OpenCode → 完成

五、安裝驗(yàn)證（必做）

5.1 命令驗(yàn)證

# 檢查插件鏈接
ls -l ~/.config/opencode/plugins/superpowers.js
# 檢查技能鏈接
ls -l ~/.config/opencode/skills/superpowers

? 成功：顯示 -> 指向 Superpowers 目錄

5.2 OpenCode 內(nèi)驗(yàn)證

輸入 /skills list → 看到 superpowers/xxx 技能列表
輸入 /brainstorm → 觸發(fā)需求澄清對(duì)話
輸入 /write-plan → 生成開發(fā)計(jì)劃
輸入 /execute-plan → 批量執(zhí)行代碼

六、基礎(chǔ)使用（3 步上手）

6.1 核心命令（斜杠快捷）

/brainstorm       # 需求澄清（蘇格拉底式對(duì)話）
/write-plan       # 生成開發(fā)計(jì)劃（文件+代碼+測(cè)試）
/execute-plan     # 執(zhí)行計(jì)劃（自動(dòng)寫代碼+跑測(cè)試）
/skill list       # 查看所有 Superpowers 技能
/skill superpowers/test-driven-development  # 調(diào)用TDD技能

6.2 標(biāo)準(zhǔn)工作流（TDD）

需求階段：/brainstorm → 明確功能、技術(shù)棧、邊界
計(jì)劃階段：/write-plan → 生成精確任務(wù)清單
開發(fā)階段：/execute-plan → AI 自動(dòng)寫測(cè)試→代碼→重構(gòu)
驗(yàn)收階段：自動(dòng)驗(yàn)證、代碼審查、分支管理

6.3 示例：生成登錄模塊

# 1. 需求
/brainstorm 開發(fā)用戶登錄模塊：手機(jī)號(hào)+密碼、JWT 認(rèn)證、錯(cuò)誤處理、測(cè)試用例
# 2. 計(jì)劃
/write-plan 基于上述需求，生成 TDD 開發(fā)計(jì)劃
# 3. 執(zhí)行
/execute-plan 按計(jì)劃編寫代碼、單元測(cè)試、集成測(cè)試

七、常見問題 & 避坑指南

7.1 安裝失敗

問題：鏈接創(chuàng)建失?。╓indows）? 解決：以管理員身份運(yùn)行 CMD/PowerShell
問題：克隆慢? 解決：用 Gitee 鏡像：https://gitee.com/mirrors/superpowers.git
問題：技能不顯示? 解決：完全重啟 OpenCode（結(jié)束進(jìn)程）

7.2 使用異常

問題：AI 不遵守 TDD? 解決：開頭必加 /brainstorm 或 /skill using-superpowers
問題：命令無效? 解決：檢查 /skills list 是否有 superpowers 技能
問題：舊版本沖突? 解決：清理舊鏈接 → 重新安裝

rm -rf ~/.config/opencode/superpowers
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers

7.3 權(quán)限問題

Windows：必須管理員權(quán)限或開發(fā)者模式創(chuàng)建符號(hào)鏈接
macOS/Linux：確保 ~/.config/opencode 目錄有讀寫權(quán)限

八、更新與卸載

8.1 更新（手動(dòng)版）

# macOS/Linux
cd ~/.config/opencode/superpowers && git pull
# Windows
cd %USERPROFILE%\.config\opencode\superpowers && git pull

重啟 OpenCode 生效

8.2 卸載

# macOS/Linux
rm -rf ~/.config/opencode/superpowers
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
# Windows
rmdir /s /q %USERPROFILE%\.config\opencode\superpowers
del %USERPROFILE%\.config\opencode\plugins\superpowers.js
rmdir /s /q %USERPROFILE%\.config\opencode\skills\superpowers

九、總結(jié)

Superpowers 是 OpenCode 必備的工程化增效插件，徹底解決 AI 編碼不規(guī)范、難維護(hù)、BUG 多的痛點(diǎn)。推薦優(yōu)先用方式 A（自動(dòng)安裝），1 行配置搞定；Windows / 舊版用方式 B（手動(dòng)）。

下一步：安裝后直接用 /brainstorm 啟動(dòng)你的第一個(gè) TDD 項(xiàng)目，體驗(yàn) AI 工業(yè)級(jí)編碼！

?? 本文說明

版本：2026.04 最新（適配 OpenCode 最新版）
平臺(tái)：macOS/Linux/Windows 全覆蓋
來源：官方文檔 + 實(shí)測(cè)驗(yàn)

擴(kuò)展：Open Code教程（五）| Skills 之 Superpowers 安裝

Open Code教程（五）| Skills 之 Superpowers 安裝

官方安裝方式

相關(guān)鏈接：https://github.com/obra/superpowers/blob/main/.opencode/INSTALL.md

// opencode.json
{
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}

重啟 OpenCode 后自動(dòng)安裝。

為什么 Windows 上用不了

Bun 在 Windows 上下載 git 包時(shí)存在 SSL 證書驗(yàn)證問題：

error: UNABLE_TO_VERIFY_LEAF_SIGNATURE downloading tarball superpowers@github:obra/superpowers

macOS/Linux 正常，Windows 失敗。

Windows 安裝方式

安裝步驟

# 1. 克隆倉庫（刪除舊的，重新克?。?
Remove-Item -Path "$env:USERPROFILE\.config\opencode\superpowers" -Recurse -Force -ErrorAction SilentlyContinue
git clone --depth 1 https://github.com/obra/superpowers.git "$env:USERPROFILE\.config\opencode\superpowers"
# 2. 創(chuàng)建目錄（公共目錄，不存在才創(chuàng)建）
if (-not (Test-Path "$env:USERPROFILE\.config\opencode\plugins")) {
    New-Item -ItemType Directory -Path "$env:USERPROFILE\.config\opencode\plugins" | Out-Null
}
if (-not (Test-Path "$env:USERPROFILE\.config\opencode\skills")) {
    New-Item -ItemType Directory -Path "$env:USERPROFILE\.config\opencode\skills" | Out-Null
}
# 3. 復(fù)制插件文件（直接覆蓋，確保最新）
Copy-Item -Path "$env:USERPROFILE\.config\opencode\superpowers\.opencode\plugins\superpowers.js" -Destination "$env:USERPROFILE\.config\opencode\plugins\superpowers.js" -Force
# 4. 創(chuàng)建鏈接（已存在則重建，確保指向正確）
if (Test-Path "$env:USERPROFILE\.config\opencode\skills\superpowers") {
    Remove-Item -Path "$env:USERPROFILE\.config\opencode\skills\superpowers" -Force
}
New-Item -ItemType Junction -Path "$env:USERPROFILE\.config\opencode\skills\superpowers" -Target "$env:USERPROFILE\.config\opencode\superpowers\skills" | Out-Null

更新

cd "$env:USERPROFILE\.config\opencode\superpowers"
git pull

卸載

# 刪除插件文件
Remove-Item -Path "$env:USERPROFILE\.config\opencode\plugins\superpowers.js" -Force -ErrorAction SilentlyContinue
# 刪除 skills 鏈接
Remove-Item -Path "$env:USERPROFILE\.config\opencode\skills\superpowers" -Force -ErrorAction SilentlyContinue
# 刪除倉庫
Remove-Item -Path "$env:USERPROFILE\.config\opencode\superpowers" -Recurse -Force -ErrorAction SilentlyContinue

驗(yàn)證

重啟 OpenCode，輸入：

Tell me about your superpowers

到此這篇關(guān)于OpenCode 安裝 superpowers 完全攻略的文章就介紹到這了,更多相關(guān)OpenCode 安裝 superpowers 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

到此這篇關(guān)于OpenCode 安裝 superpowers 完全攻略的文章就介紹到這了,更多相關(guān)OpenCode 安裝 superpowers 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

IntelliJ IDEA AI Assistant 攜帶OpenCode保姆級(jí)安裝教程

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

OpenCode 安裝 superpowers 完全攻略

目錄

OpenCode 安裝 superpowers 技能

一、Superpowers 核心介紹

1.1 是什么

1.2 技能清單（14 個(gè)核心）

二、環(huán)境準(zhǔn)備（必看）

2.1 前提條件

2.2 安裝方式（2 種）

三、方式 A：自動(dòng)安裝（推薦?2026 最新）

3.1 步驟 1：編輯配置文件

3.2 步驟 2：重啟 OpenCode

3.3 步驟 3：驗(yàn)證安裝

四、方式 B：手動(dòng)安裝（全平臺(tái)通用?舊版兼容）

4.1 macOS / Linux 手動(dòng)安裝

步驟 1：克隆 Superpowers 倉庫

步驟 2：創(chuàng)建目錄（不存在則新建）

步驟 3：清理舊鏈接（避免沖突）

步驟 4：創(chuàng)建符號(hào)鏈接（核心）

步驟 5：重啟 OpenCode → 完成

4.2 Windows 手動(dòng)安裝（CMD/PowerShell）

步驟 1：克隆倉庫

步驟 2：創(chuàng)建目錄

步驟 3：清理舊鏈接

步驟 4：創(chuàng)建鏈接（管理員權(quán)限）

步驟 5：重啟 OpenCode → 完成

五、安裝驗(yàn)證（必做）

5.1 命令驗(yàn)證

5.2 OpenCode 內(nèi)驗(yàn)證

六、基礎(chǔ)使用（3 步上手）

6.1 核心命令（斜杠快捷）

6.2 標(biāo)準(zhǔn)工作流（TDD）

6.3 示例：生成登錄模塊

七、常見問題 & 避坑指南

7.1 安裝失敗

7.2 使用異常

7.3 權(quán)限問題

八、更新與卸載

8.1 更新（手動(dòng)版）

8.2 卸載

九、總結(jié)

?? 本文說明

Open Code教程（五）| Skills 之 Superpowers 安裝

官方安裝方式

為什么 Windows 上用不了

Windows 安裝方式

安裝步驟

更新

卸載

驗(yàn)證

相關(guān)文章

最新評(píng)論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

一、Superpowers 核心介紹

二、環(huán)境準(zhǔn)備（必看）

四、方式 B：手動(dòng)安裝（全平臺(tái)通用?舊版兼容）

五、安裝驗(yàn)證（必做）

七、常見問題 & 避坑指南

八、更新與卸載

九、總結(jié)