opencode-bootstrap

一鍵重現本機 opencode 設定。superpowers plugin 與 harness-creator skill 的原始碼都已內建打包，setup 過程不需連到外部 git。

一鍵 setup

設定 proxy（選用，企業網路環境）後執行：

export PROXY=http://your-proxy:port
curl -fsSL -k --proxy "$PROXY" \
  https://raw.githubusercontent.com/wys1203/opencode-bootstrap/main/setup.sh | bash

沒有 proxy 時：

curl -fsSL -k https://raw.githubusercontent.com/wys1203/opencode-bootstrap/main/setup.sh | bash

本地執行（已將整包帶到目標機器時）：

./setup.sh

Proxy 與 TLS

• setup.sh 內所有 curl 一律帶 -k（跳過 TLS 憑證驗證，配合會攔截 TLS 的企業 proxy）
• proxy 來源依序為環境變數 PROXY → HTTPS_PROXY → https_proxy，有設定就以 --proxy 傳給 curl
• 用 curl | bash 時請先 export PROXY=...，piped 的 bash 才會繼承

setup.sh 做什麼

1. 安裝內建 bundle —— 腳本旁有對應 .tar.gz 就用本地檔，否則 curl 抓 raw：
   • superpowers → ~/.config/opencode/superpowers/
   • harness-creator → ~/.config/opencode/skills/harness-creator/ （重跑會先清掉舊版）
2. 取得 opencode.json —— 同樣本地優先、否則 curl
3. 用 python3 驗證 JSON 格式（無 python3 則略過）
4. 既有的 opencode.json 自動備份成 opencode.json.bak.<timestamp>
5. 寫入新的 opencode.json

可用 RAW_BASE 環境變數覆寫下載來源（測試或切換 branch 用）。

設定內容

opencode.json：

• plugin → 本地 ./superpowers/.opencode/plugins/superpowers.js
• Ollama 本地 provider：qwen2.5-coder:7b，走 http://localhost:11434/v1

harness-creator skill 裝在 ~/.config/opencode/skills/harness-creator/ —— opencode 預設會自動掃描 ~/.config/opencode/skills/，不需在 opencode.json 額外設定。

內建 bundle：

Bundle	內容	來源
superpowers.tar.gz	superpowers plugin + skills（v5.0.4，排除 tests/、.github/）	obra/superpowers
harness-creator.tar.gz	harness-creator skill（SKILL.md + references + scripts + templates）	walkinglabs/learn-harness-engineering

維護：更新內建 bundle

vendor.sh 供 maintainer 在「有網路」的機器上重新打包：

./vendor.sh                   # 重打包全部
./vendor.sh superpowers       # 只重打包 superpowers
./vendor.sh harness-creator   # 只重打包 harness-creator
git add *.tar.gz && git commit && git push

刻意不做

setup.sh 只負責設定與內建 bundle。以下需自行處理：

項目	做法
安裝 / 升級 opencode	見 https://opencode.ai；升級用 opencode upgrade
provider 登入（Anthropic / Gemini / OpenAI）	opencode auth login
Ollama 與模型	安裝 Ollama 後 ollama pull qwen2.5-coder:7b