antigravity-skill

🌌 Antigravity 專用教學與自動化技能集 (Antigravity Skills)

本專案是專為 Antigravity (Gemini AI 助理) 所量身打造的整合技能集。 包含教學簡報製作、課堂公開課影片分析與學校 AI 秘書建立等多元自動化技能。

相較於原始的 Claude Code 版本，此版本針對 Antigravity 進行了以下優化：

  1. 免 API Key 原生生圖：不再需要設定額外付費的 OpenAI draw 腳本，改為呼叫 Antigravity 內建的 generate_image 繪圖引擎。
  2. 自動化目錄同步：產生的圖片會從 Antigravity 的臨時 Artifacts 目錄中自動被複製到專案對應的圖片目錄。
  3. 無縫載入：直接放置在工作區的自訂路徑中（.agents/skills/），AI 助理在對話開始時即可自動載入使用。

🛠️ 五大核心技能介紹

本技能集包含三種輸出格式的技能，以滿足不同的教學場景需求：

1. 🖼️ SOIL 純圖片教學簡報 (soil-image-deck)

2. 📝 SOIL 可編輯教學簡報 (soil-teaching-deck)

3. 🌐 SOIL 互動式網頁簡報 (soil-html-deck)

4. 📹 課堂公開課影片分析與課例研究 (classroom-video-analyzer)

5. 🤖 學校 AI 秘書建立器 (school-secretary-builder)

⚙️ 技能安裝路徑與依賴

1. 目錄結構

本技能放置於工作區的自訂技能目錄 .agents/ 底下：

.agents/
└── skills/
    ├── classroom-video-analyzer/
    │   ├── SKILL.md
    │   └── scripts/
    │       └── classroom_analyzer_helper.py
    ├── school-secretary-builder/
    │   ├── SKILL.md
    │   ├── scripts/
    │   │   └── builder_cli.py
    │   └── templates/
    │       ├── app.js.template
    │       ├── index.html.template
    │       └── styles.css.template
    ├── soil-html-deck/
    │   └── SKILL.md
    ├── soil-image-deck/
    │   ├── SKILL.md
    │   └── scripts/
    │       └── pack_pptx.py
    └── soil-teaching-deck/
        └── SKILL.md

2. 依賴套件安裝

在執行簡報打包、轉譯分析與網頁生成時，您的本地電腦需要準備以下套件：

# 安裝 Python 依賴（簡報打包、影片轉譯、網頁爬蟲與生圖）
pip install Pillow python-pptx cairosvg pyyaml faster-whisper yt-dlp beautifulsoup4 requests --break-system-packages

# 安裝 Node.js 依賴（用於 PptxGenJS 與 Mock DOM 測試）
npm install -g pptxgenjs jsdom

🛠️ 全平台服務連接與整合指南 (整合懶人包)

本專案提供了一套終極整合方案，協助您的 AI 助理連接本機與雲端的所有主流服務：

1. 🎯 連接 Google NotebookLM (MCP)

  1. 安裝 CLI 工具： 
    pip install notebooklm-mcp-cli
  2. 登入 Google 帳號： 
    nlm login
  3. 繞過 Windows CP950 編碼錯誤（關鍵防踩坑）： 在 Windows 終端機執行 nlm 指令前，務必加上 PYTHONIOENCODING=utf-8 環境變數： 
    $env:PYTHONIOENCODING="utf-8"
nlm list

2. 🎯 連接 Firebase 資料庫

  1. 安裝 Firebase CLI： 
    npm install -g firebase-tools
  2. 繞過 Windows PowerShell 執行原則限制 (PSSecurityException)： Windows 預設會拒絕載入 firebase.ps1。請使用 CMD 包裝器 執行： 
    cmd /c firebase login
cmd /c firebase projects:list

3. 🎯 連接 GitHub 帳戶

  1. 驗證與登入： 使用 GitHub CLI 進行網頁端安全授權： 
    $env:GITHUB_TOKEN=""  # 確保清除 AI 代理人的權限干擾
gh auth login --web --git-protocol https
gh auth status
  2. 設定 Git 全域使用者資訊： 
    git config --global user.name "您的名字"
git config --global user.email "您的email@example.com"

4. 🎯 連接 Obsidian 第二大腦

  1. 安裝全域 MCP 伺服器： 
    npm install -g @bitbonsai/mcpvault
  2. 設定 opencode.json： 在您專案根目錄建立 opencode.json，將實體路徑指向您的 Obsidian Vault 目錄（例如 G:\\我的雲端硬碟\\secondbrain）： 
    {
  "mcp": {
    "obsidian": {
      "type": "local",
      "command": ["npx", "@bitbonsai/mcpvault", "G:\\我的雲端硬碟\\secondbrain"],
      "enabled": true
    }
  }
}

🟢 專案自動化 SOP 工作流 (ANTIGRAVITY.md)

當您在對話中對 AI 助理說出關鍵字時，將會自動觸發定義於 ANTIGRAVITY.md 專案駕駛艙中的自動化 SOP 工作流：

1. 🟢 說「開工」或「我來了」時

AI 助理會自動：

2. 🔴 說「收工」或「下班了」時

AI 助理會自動：

3. 🔵 說「初始化專案」時

AI 助理會自動：