GEAR Wiki原創示範教學約 12 分鐘

第 3/6 集LLM Wiki 教學中心

Wiki 安裝教程 3/6|安裝商店插件與使用第一個 Skill

在 CodeBuddy 加入 Claude 插件商店,安裝並驗證 Superpowers,再建立簡單的會議摘要 Skill。

開始閱讀與練習

從這個問題開始

本課分兩部分:先安裝商店提供的插件,再建立一個只用於此知識庫的會議摘要 Skill。所有操作都在第二課的 my-wiki 資料夾內進行。

準備的工具與材料

  • 已完成第 1、2 課:工具可用,my-wiki 知識庫已建立
  • 一段不含敏感資料的示範會議筆記(本課提供)
  • 約 20 分鐘

第 1 步:確認插件功能與商店

先在 CodeBuddy 的終端機確認 CLI 版本。以下是終端機指令;若目前停留在 AI 對話,請另外開啟終端機。

配套影片 · GEAR EP03(第 3、4 課共用) 在 YouTube 觀看
終端機指令
codebuddy --version
codebuddy plugin --help

預期結果:顯示版本號及插件管理說明。CodeBuddy 支援插件商店,也能使用相容的 Claude 商店插件;這不代表每個插件的外部服務、依賴和權限都自動可用。

接著在終端機逐行加入並列出商店:

終端機指令
codebuddy plugin marketplace add anthropics/claude-plugins-official
codebuddy plugin marketplace list

預期結果:清單內出現 claude-plugins-official。若它原本已存在,直接使用,不需要重複加入。若出現讀取或格式錯誤,先保留完整錯誤並核對官方插件文件,不要繼續安裝。

第 2 步:安裝並檢查 Superpowers

Superpowers 是包含規劃、除錯及驗收方法的第三方插件,Claude 官方商店有收錄。先閱讀它的 README,知道內容與用途,再在終端機輸入:

終端機指令
codebuddy plugin install superpowers@claude-plugins-official
codebuddy plugin list --json

預期結果:已安裝清單出現 superpowers,顯示已啟用,且沒有尚未處理的依賴錯誤。商店名稱以清單實際顯示為準。

關閉舊 CodeBuddy 對話,在 my-wiki 內重新執行 codebuddy。可在新的 CodeBuddy 對話輸入 /plugin 查看插件管理畫面;這是 AI 對話內的指令,不是在系統終端機輸入 /plugin。

第 3 步:用一個小任務驗證插件

在新的 CodeBuddy 對話輸入:

CodeBuddy 對話指令
請確認目前已啟用的 Superpowers 插件,讀取其中的 brainstorming 方法。
我要規劃一場30分鐘的客戶需求會議。
請先詢問會議目的、參與者與限制,再提出議程草稿。
只在對話回答,不建立檔案、不聯絡客戶。

核對助手指出的插件或 Skill 來源,並確認它先釐清需求、再給議程。只得到一份看似合理的議程,不能證明插件已載入;要同時檢查已安裝/啟用狀態及實際讀取來源。

開始自建 Skill 前:確認儲存位置

按 CodeBuddy 官方文件,Skill 有兩個層級:項目級放在該項目資料夾的 .codebuddy/skills/ 內,只對該項目生效;用戶級放在你帳戶主目錄的 ~/.codebuddy/skills/ 內,對所有項目生效。本課用項目級,位置是 my-wiki/.codebuddy/skills/meeting-summary/SKILL.md。每個 Skill 是一個資料夾,資料夾名就是 Skill 名,裡面必有一個 SKILL.md 檔案。

第 4 步:建立項目專用的會議摘要 Skill

.codebuddy 是隱藏資料夾(名稱以點開頭),在 Finder 或檔案總管未必直接看到。最穩妥的做法:在編輯器的檔案總管對 my-wiki 按右鍵新增資料夾,逐層建立 .codebuddy → skills → meeting-summary,再在裡面新增 SKILL.md。也可以在 CodeBuddy 對話要求 AI 按這個確切路徑建立,建成後你在檔案總管打開核對。

SKILL.md 的內容如下(整段複製):

SKILL.md 內容
---
name: meeting-summary
description: 把會議筆記整理為決策、待辦、未知三個部分
---

# 會議摘要

收到會議筆記時,輸出三個部分:
1. 決策:會議中已拍板的事項
2. 待辦:每項寫明負責人與期限;筆記沒有提供的,寫「未提供」,不要猜
3. 未知:會議中提出但未解答的問題

規則:只整理筆記裡有的內容,不補充猜測;除非你明確要求,否則不修改任何檔案,只在對話輸出。

開頭的 YAML 區塊(兩條 --- 之間)用來清楚標示名稱與用途:name 是 Skill 名,description 告訴 AI 什麼情況用這個 Skill。儲存檔案。

第 5 步:核對會議摘要輸出

在 CodeBuddy 對話輸入:

在 CodeBuddy 對話輸入
請閱讀 .codebuddy/skills/meeting-summary/SKILL.md,然後按它的規格整理以下會議筆記:

2026-10-15 產品會議
- 決定下月推出試用版,由阿明負責,10 月 30 日前交原型
- 定價未決定,下次會議再議
- 阿欣提出需要更多用戶訪談資料

預期結果:輸出分「決策、待辦、未知」三部分;「定價」出現在未知或註明未決定;待辦有負責人與期限;沒有憑空新增筆記裡沒有的事項。

常見問題

CodeBuddy 可以使用相容的 Claude 插件商店。個別插件的 hooks、MCP 或外部服務仍可能有額外設定,安裝時要逐項核對。

自建 Skill 的 .codebuddy 資料夾可能在系統檔案總管隱藏;可以直接在 CodeBuddy 的檔案樹建立。若新檔未被識別,重新開啟對話,並明確要求讀取該 SKILL.md。

完成清單

  1. 商店清單可找到 claude-plugins-official。
  2. Superpowers 已列為安裝並啟用,沒有未處理的依賴錯誤。
  3. 新對話已確認插件來源,並完成一個先釐清需求的測試。
  4. meeting-summary/SKILL.md 已建立,會議摘要測試沒有補寫不存在的負責人或日期。

官方參考

CodeBuddy 插件市場 · 插件指令及驗證 · CodeBuddy 使用 Claude 官方商店的例子 · Claude 官方商店清單 · Superpowers · CodeBuddy Skills。文件核對日期:2026-10-19;實際相容性以所用版本、清單及任務驗證為準。

接著讀,也接著練習。