opencode-lazy-packs

OpenCode 懶人包 — AI Agent 安裝入口

使用者把這個 repo 網址丟給你、說要安裝時，照以下流程執行。

🎯 這份檔案的工作是「問清楚再動手」，不是「一口氣裝完」。 對象是零程式基礎的老師，裝錯比裝慢貴得多。

---

步驟一：列出可用的懶人包

主線 11 包在 skills/ 底下，另有 2 包加碼路線在 extras/。 把下表原樣列給使用者看：

編號	skill 名	名稱	階梯	前置	狀態
00	00-env-setup	環境建置（OpenCode、Git、gh、Node.js、uv）	地基	無	✅
01	01-connect-model	連接免費模型（OpenCode Zen）	地基	#00	✅
02	02-file-toolkit	內部工具包（文件／影音／語音）	內部工具	#00	✅
03	03-notebooklm	連接 NotebookLM	外部工具	#00、#01	✅
04	04-obsidian	連接 Obsidian 第二大腦	外部工具	#00、#01、有 vault	✅
05	05-sheets-gas	Google Sheets ＋ Apps Script 後端	資料庫	#00	✅
06	06-supabase	Supabase 即時資料庫	資料庫	00	✅
07	07-github	連接 GitHub（三階段）	跨電腦	#00	✅
08	08-workflow-skills	開工／收工／初始化技能	跨電腦	#00；L2 要 #07、L3 要 #04	✅
09	09-groq-api	Groq API：轉字幕 ＋ 文字清洗	API	#00、#01、#02	✅
10	10-netlify	Netlify 部署與後端藏金鑰	API	#00、#09	✅

加碼（不要主動推薦，使用者問到才提）：

路徑	名稱
extras/firebase	連接 Firebase（即時資料庫的替代方案，主線走 06-supabase）
extras/browser	瀏覽器控制

列表時一定要附上這兩句話：

• 「#00 裝完，OpenCode 還不會回答你，一定要接著做 #01 才會動。」
• 「#10 要先做完 #09，因為它示範的後端要帶一把 API 金鑰。」

---

步驟二：問使用者要裝哪些

以上是這份懶人包的所有項目。

你可以：
- 輸入「全部」→ 依編號順序一包一包裝
- 輸入編號組合 → 例如「00, 01, 03」只裝這三個
- 第一次用、不知道選什麼 → 建議先做「00, 01」，那是地基
- 已經裝過的項目 → 告訴我，我會跳過

你要安裝哪些？

等使用者回答，不要自己決定。 沒回答就不要開始裝。

順序與前置檢查

• 使用者選了 #03 但沒做過 #00／#01 → 先提醒：「這包需要先完成 #00 和 #01，要順便一起做嗎？」等他回答。
• 不管使用者用什麼順序報編號，實際安裝一律照編號由小到大。
• 使用者選到 #10 但沒做過 #09 → 提醒他 #10 的範例需要一把 API 金鑰，問要不要先做 #09。
• 🔴 執行 #10 時：沒有使用者明確同意，不准跑 netlify deploy --prod（一次扣 15 點，每月只有 300 點）。預設一律草稿部署。

---

步驟三：一次裝一包

對使用者選的每一個 skill：

npx skills add mathruffian-dot/opencode-lazy-packs --skill <skill名稱> -g -y

⚠️ 如果 npx skills add 不能用（環境不支援、沒有網路、公司電腦擋住），改為手動安裝： 讀取 skills/<名稱>/SKILL.md 的完整內容，照裡面的步驟一步一步執行。 內容是一樣的——一鍵安裝只是把同一份檔案放進 ~/.config/opencode/skills/。

extras/ 的兩包不在 skills/ 目錄下，一鍵安裝不一定抓得到，直接讀 extras/<名稱>/SKILL.md 照做。

執行時遵守

1. 先偵測再安裝：已經有的工具不要重裝。
2. 每步都要驗證：跑驗證指令、看到預期輸出才算過。
3. 需要人動手的地方停下來：登入、授權、輸入驗證碼、需要管理員權限——講清楚要做什麼，等使用者回覆。
4. 不要代填金鑰或密碼，不要幫使用者選付費方案。
5. Windows 一律用 PowerShell，串指令用 ; 不要用 &&（PowerShell 5.1 會語法錯誤）。
6. 失敗就停下來問，不要自己改指令硬闖、也不要跳過去裝下一包。

---

步驟四：每包裝完都要回報

依該 skill 檔案裡的「完成回報格式」回報。然後：

• 還有下一包要裝 → 說一句「接下來是 #XX」，繼續。
• 全部裝完 → 列一張總表：

## 安裝完成

| 懶人包 | 結果 | 備註 |
|--------|------|------|
| #00 環境建置 | ✅ / ⚠️ / ❌ | |
| #01 連接模型 | ✅ / ⚠️ / ❌ | |

- 需要你手動處理的事：（沒有 / 條列）
- 建議下一步：

（✅ 完成 ／ ⚠️ 部分完成 ／ ❌ 失敗，失敗一定要寫原因。）

---

補充說明

• 完整內容都在 skills/<名稱>/SKILL.md，需要細節時直接讀那份檔案，不要靠這張表推測步驟。
• 版本紀錄只看 CHANGELOG.md，各技能檔內不再標版本。
• 更詳細的 repo 導覽（編號原則、使用者說什麼該去哪一包、修改本 repo 的規則）在 AGENTS.md。
• 不要一次把整份研習裝完，除非使用者明確說「全部」。裝一包、回報、等指示，是這份入口的預設節奏。