mcpField
O
opencode-lazy-packs

opencode-lazy-packs

github.com/mathruffian-dotAgent 工作流64149 次安装8 周前更新
代码仓库

关于 opencode-lazy-packs

面向编程经验较少教师的 OpenCode 技能包安装入口。它先列出选项并检查前置条件,再逐包引导安装,过程中等待用户决定并验证步骤。

主要功能

  1. 01列出 11 个主线包和 2 个加码包
  2. 02检查前置条件与安装顺序
  3. 03每次安装一个技能包
  4. 04验证每步并在失败时暂停
  5. 05提供手动安装备用方案
  6. 06生产部署前要求明确同意

适用场景

  1. 01按编号选择 OpenCode 配置包
  2. 02在检查前置条件后安装技能包
  3. 03引导初次使用者完成环境设置
  4. 04处理登录、授权或安装失败

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mathruffian-dot/opencode-lazy-packs --skill opencode-lazy-packs

安装后在 Claude Code 中输入/opencode-lazy-packs确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

AGENTS.md
.gitignore
CHANGELOG.md
LICENSE
README.md

详细介绍

来自项目 README

OpenCode 懶人包 — AI Agent 安裝入口

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

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


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

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

編號skill 名名稱階梯前置狀態
0000-env-setup環境建置(OpenCode、Git、gh、Node.js、uv)地基無✅
0101-connect-model連接免費模型(OpenCode Zen)地基#00✅
0202-file-toolkit內部工具包(文件/影音/語音)內部工具#00✅
0303-notebooklm連接 NotebookLM外部工具#00、#01✅
0404-obsidian連接 Obsidian 第二大腦外部工具#00、#01、有 vault✅
0505-sheets-gasGoogle Sheets + Apps Script 後端資料庫#00✅
0606-supabaseSupabase 即時資料庫資料庫00✅
0707-github連接 GitHub(三階段)跨電腦#00✅
0808-workflow-skills開工/收工/初始化技能跨電腦#00;L2 要 #07、L3 要 #04✅
0909-groq-apiGroq API:轉字幕 + 文字清洗API#00、#01、#02✅
1010-netlifyNetlify 部署與後端藏金鑰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。
  • 不要一次把整份研習裝完,除非使用者明確說「全部」。裝一包、回報、等指示,是這份入口的預設節奏。

评论

支持 Markdown