INSTALL GUIDE / 03 OF 03

Geminiへの導入

Gemini CLIとGeminiアプリ向けの導入方法を確認できます

DOCUMENTATION / Gemini手順と注意事項

在 Gemini 中安裝 KUMIHAN

日本語 ・ English ・ 返回首頁


這份指南說明如何在 Gemini CLI 或 Gemini 應用程式中使用 KUMIHAN。

關於 v0.2.0 此版本供你在自己的環境中試用。各工具的實際運作尚未經過充分驗證,因此部分步驟可能無法如預期使用。


1. 選擇安裝方式

使用環境 建議方式
Gemini CLI(一次安裝四項技能) A. 安裝為擴充功能
Gemini CLI(只安裝需要的技能) B. 選擇個別技能安裝
Gemini 應用程式(Web、Mac、手機) C. 上傳技能


A. Gemini CLI:安裝為擴充功能

一次安裝四項技能的方法:

gemini extensions install https://github.com/landco-llc/kumihan --ref main

若出現確認畫面,請先檢查內容再繼續。擴充功能安裝後會在所有專案啟用。

更新時

gemini extensions update kumihan

更新後請重新啟動 Gemini CLI。

從 ZIP 安裝時

  1. 下載擴充功能 ZIP。
  2. 建立空的 kumihan 資料夾,並將 ZIP 內容解壓縮到其中。
  3. 指定資料夾並安裝。

    gemini extensions install "/absolute/path/kumihan"
    

從 ZIP 安裝時不會自動更新。新版本推出後需自行替換 ZIP。


B. Gemini CLI:選擇個別技能安裝

此方式可以只在指定專案安裝需要的技能。若已透過 A 安裝,便不必再執行此步驟。

例如在目標專案安裝 kumihan:

gemini skills install https://github.com/landco-llc/kumihan --path skills/kumihan --scope workspace

若要安裝其他技能,請將 --path 改為:

  • skills/kumihan-web — 網頁製作
  • skills/kumihan-documents — 報告與簡報
  • skills/kumihan-review — 成果檢視

--scope workspace 表示只在這個專案使用。若省略,技能將可供所有專案使用。

更新時

再次執行相同指令。已安裝的技能會被取代,若曾自行修改請先備份。


C. Gemini 應用程式:上傳技能

  1. 下載想使用的技能 ZIP。
  2. 在 Gemini 開啟 Customize(若未看到,可先點選 More)→ Skills → Upload。
  3. 逐一選擇 ZIP、確認內容後按下 Create。

注意事項

  • 依原始指南所述,此功能目前僅提供給年滿 18 歲的個人 Google 帳號;工作或學校帳號尚不支援。
  • 需啟用「Keep Activity」(保留活動紀錄)。
  • 功能分階段開放,你可能尚未看到相關選項。請參閱 Gemini 官方說明。
  • 此處不能使用 Gemini CLI 的擴充功能 ZIP。
  • 上傳的技能不會自動更新。新版本推出時需重新上傳。


2. 開始試用

建議先以不會修改檔案的要求測試:

我準備製作一份日文簡報。請告訴我需要注意哪些排版與設計要點,不要修改任何檔案。


驗證下載檔案(選用)

若要檢查下載檔案是否完整,可使用 SHA256SUMS.txt。

將檔案放在與下載目錄相同的結構(extensions/ 和 skills/),並在終端機執行以下命令。若無 shasum,可使用 Windows PowerShell 的 Get-FileHash 等工具檢查 SHA-256:

cd "downloads Gemini"
shasum -a 256 -c SHA256SUMS.txt

若每一行都顯示 OK,即表示校驗成功。



其他工具:ChatGPT/Codex ・ Claude

介面及功能開放條件可能變更;請以各服務的官方說明為準(原始指南確認日期:2026 年 10 月 14 日)。