Antigravity Github

AntiGravity 懶人包 — AI Agent 自動安裝入口

當使用者給你這個 repo 網址並說要安裝時，請依以下流程執行。

步驟一：認識可用懶人包

步驟二：讓使用者選擇

列出上表給使用者看，然後問：「你要安裝哪些？輸入全部或編號組合（例如 01, 02, 03）。」

步驟三：依序安裝

對選取的每個 skill：

npx skills add mathruffian-dot/antigravity-lazy-pack --skill <skill名稱> -g -y

若 npx skills add 無法使用，改為手動：讀取 skills/<名稱>/SKILL.md 內容並執行。

步驟四：回報結果

每項回報安裝狀態（✅/⚠️/❌），最後列總表。

Anti-Gravity 懶人包 #09：服務連接與工作流程設定

版本：v1.4

更新日期：2026-05-31

語系偏好：繁體中文（Taiwan）

這份懶人包的目標，是讓 Anti-Gravity 使用者能安全連接 NotebookLM、Firebase、GitHub、Obsidian，並建立「開工 / 收工 / 新專案初始化」工作流程。本版本已重新加回了 Obsidian MCPVault 的一鍵整合設定與專屬 Skill。

本文件只放可公開教學的設定流程，不放任何個人 NotebookLM 清單、筆記本 ID、研究報告、生成圖片、帳號 token 或測試專案。

---

先備條件

• [ ] 已安裝 Anti-Gravity 或可使用 MCP 的 AI 編碼助理
• [ ] 已安裝 Git
• [ ] 已安裝 GitHub CLI（gh）
• [ ] 已安裝 Node.js / npm
• [ ] 已安裝 Python 或 uv
• [ ] 有 Google 帳號，可登入 NotebookLM / Firebase
• [ ] 有 GitHub 帳號
• [ ] 已有 Obsidian vault，或知道筆記本資料夾位置

Windows 快速檢查：

git --version
gh --version
node --version
npm.cmd --version
python --version

---

一、連接 NotebookLM

重點原則

NotebookLM 登入應走瀏覽器 OAuth 授權。不要複製 cookie、token，也不要把 NotebookLM 匯出的 notebooks.json 或筆記本 ID 清單放進公開 repo。

安裝 NotebookLM MCP CLI

建議優先用 uv 安裝：

uv tool install notebooklm-mcp-cli
nlm --version

如果沒有 uv，再用 pip：

pip install notebooklm-mcp-cli
nlm --version

重新登入 Google 帳號

若曾經登入錯帳號，先登出再重新 OAuth：

nlm logout
nlm login

nlm login 會開啟瀏覽器，請在瀏覽器選擇正確的 Google 帳號完成授權。

驗證：

nlm doctor
nlm list

如果 Windows 顯示 CP950 / Unicode 編碼錯誤，可在同一個 PowerShell 視窗先設定：

$env:PYTHONIOENCODING = "utf-8"
nlm doctor

註冊 MCP

Anti-Gravity 的 MCP 設定檔位置請以實際產品文件或 UI 為準。不要直接套用 OpenCode 的 opencode.json，除非 Anti-Gravity 明確使用同一個設定檔。

通用設定概念：

{
  "mcp": {
    "notebooklm": {
      "type": "local",
      "command": ["nlm", "mcp"],
      "enabled": true
    }
  }
}

完成後重啟 Anti-Gravity，請它列出 NotebookLM 筆記本。只回報是否成功，不要把完整清單 commit 到 repo。

---

二、連接 GitHub

登入 GitHub CLI

gh auth status
gh auth login --web --git-protocol https
gh auth status

若登入流程卡住，請在可互動的 PowerShell 視窗完成瀏覽器授權，再回來驗證。

設定 Git 使用者

git config --global user.name "你的名字"
git config --global user.email "your-email@example.com"

若不想公開個人信箱，可使用 GitHub no-reply email。

安全規則

• GitHub 與 GitHub Copilot 是不同服務；本流程只需要 GitHub 帳號、Git、GitHub CLI。
• 不把 GitHub token 寫進 Markdown、AGENTS、ANTIGRAVITY、Obsidian 對外筆記或 repo。
• commit 前先檢查 diff，不要無差別提交。

---

三、連接 Firebase

安裝與登入

Windows 建議使用 npx.cmd，避免 PowerShell 執行原則擋到 .ps1：

npx.cmd -y firebase-tools@latest --version
npx.cmd -y firebase-tools@latest login
npx.cmd -y firebase-tools@latest projects:list

firebase login 需要互動式瀏覽器登入。如果在 AI 對話裡卡住，請手動開 PowerShell 執行登入，再回來讓 AI 驗證。

註冊 Firebase MCP

Anti-Gravity 的 MCP 設定檔位置請以實際產品文件或 UI 為準。設定概念如下：

{
  "mcp": {
    "firebase": {
      "type": "local",
      "command": ["npx.cmd", "-y", "firebase-tools@latest", "mcp"],
      "enabled": true
    }
  }
}

完成後重啟 Anti-Gravity，測試列出 Firebase 專案與 Firestore 集合。

安全規則

• Firebase 前端 config 可公開，但 Admin SDK 憑證不可公開。
• .firebaserc 若含私人專案 ID，公開前請確認是否適合。
• 學生資料只存班級代號與座號，不存真名。

---

四、連接 Obsidian

找到 vault

請先確認 Obsidian vault 的實體路徑。常見位置：

C:\Users\<你>\OneDrive\文件\Secondbrain
C:\Users\<你>\Documents\<vault 名稱>
G:\我的雲端硬碟\<vault 名稱>

確認條件：

• 資料夾存在
• 裡面有 .obsidian
• 是你平常真正使用的那個 vault

安裝 MCPVault

npm.cmd install -g @bitbonsai/mcpvault
where.exe mcpvault

常見路徑：

C:\Users\<你>\AppData\Roaming\npm\mcpvault.cmd

註冊 Obsidian MCP

不要把 OpenCode 的 opencode.json 當成 Anti-Gravity 固定格式。請依 Anti-Gravity 實際 MCP 設定方式加入：

{
  "mcp": {
    "obsidian": {
      "type": "local",
      "command": [
        "C:\\Users\\<你>\\AppData\\Roaming\\npm\\mcpvault.cmd",
        "C:\\Users\\<你>\\OneDrive\\文件\\Secondbrain"
      ],
      "enabled": true
    }
  }
}

如果 Anti-Gravity 使用 command / args 分開的格式，概念如下：

{
  "command": "C:\\Users\\<你>\\AppData\\Roaming\\npm\\mcpvault.cmd",
  "args": ["C:\\Users\\<你>\\OneDrive\\文件\\Secondbrain"]
}

完成後重啟 Anti-Gravity，先測讀取 vault 根目錄，再測建立一篇測試筆記，最後讀回確認。

---

五、生圖

如果 Anti-Gravity 內建生圖工具，可直接用自然語言產生圖片，不需要把 OpenAI API key 寫進 repo。

建議提示格式：

生成一張圖片：
用途：
尺寸比例：
主題：
畫面內容：
風格：
色彩：
文字：
限制：
輸出位置：

注意：

• 重要中文文字建議後製，生圖模型可能出字錯誤。
• 專案要引用的圖片請放在專案 assets/ 或 Obsidian 附件資料夾。
• 不要把臨時生成圖全部 commit 到懶人包 repo。

---

六、開工 / 收工 / 新專案初始化

Anti-Gravity 可使用專案根目錄的 ANTIGRAVITY.md 作為 AI 工作規則入口。它應記錄固定規則、路徑、專案邊界與 Do / Don't；進度、踩坑、每日紀錄應放 Obsidian 專案駕駛艙。

開工

使用者說「開工」時，AI 應：

1. 讀取專案根目錄的 ANTIGRAVITY.md 或同等規則檔。 2. 讀取 Obsidian 專案駕駛艙。 3. 執行 git status 與最近 commit 檢查。 4. 回報目前狀態與建議下一步。 5. 不自動 pull、commit 或 push。

收工

使用者說「收工」時，AI 應：

1. 檢查是否有敏感資料：API key、token、憑證、NotebookLM 匯出清單、學生真名。 2. 更新 Obsidian 專案駕駛艙：完成事項、下一步、踩坑。 3. 只有固定規則或路徑改變時才更新 ANTIGRAVITY.md。 4. 執行 git status 與 diff 檢查。 5. 只 stage 本次相關檔案，不使用無差別 git add .。 6. 產生 commit message，確認後 commit / push。 7. 回報 Obsidian、規則檔與 GitHub 同步結果。

新專案初始化

使用者說「新專案初始化」時，AI 應先問清楚：

• 專案名稱
• 用途
• 工作資料夾
• 是否建立 GitHub repo
• repo 公開或私有
• 是否需要 GitHub Pages / Firebase / 其他部署
• Obsidian vault 與專案駕駛艙位置

接著建立或補齊：

• ANTIGRAVITY.md
• README.md
• .gitignore
• Git repo
• GitHub repo（使用者需要時）
• Obsidian 專案駕駛艙

如果資料夾已經是既有專案，先盤點「已存在 / 缺少」清單，只補缺口，不覆蓋既有設定。

---

建議的 ANTIGRAVITY.md 範本

# <專案名稱> - ANTIGRAVITY.md

## 專案入口

專案名稱：
專案用途：
主要工作目錄：
GitHub repo：
預設 branch：

## Obsidian 對應筆記

Obsidian vault：
專案駕駛艙：

## 工作規則

- 回應使用繁體中文。
- 涉及檔案操作時回報完整產出位置。
- 使用 PowerShell 語法。
- 開工時讀本檔、讀 Obsidian 駕駛艙、檢查 Git 狀態。
- 收工時更新 Obsidian，必要時更新本檔，檢查 diff 後只提交相關檔案。
- 不把每日流水帳寫進本檔。

## 不要做

- 不要 commit API key、token、密碼、Firebase Admin 憑證。
- 不要 commit NotebookLM 個人匯出清單或筆記本 ID 清單。
- 不要自動納入無關 git 變更。
- 不要儲存學生真名；正式資料只用班級代號與座號。

---

完成回報格式

## Anti-Gravity 懶人包設定完成

- NotebookLM：已登入 / 待 OAuth / 失敗
- GitHub：已登入 / 待登入 / 失敗
- Firebase：已登入 / 待登入 / 未使用
- Obsidian：已連接 / 待設定 / 失敗
- 規則檔：ANTIGRAVITY.md 已建立 / 已更新 / 未建立
- Git 狀態：乾淨 / 有未提交變更
- 下一步：

---

常見問題

---

更新紀錄

Anti-Gravity 懶人包

這個 repo 只放 Anti-Gravity 使用者可公開套用的懶人包文件，不放個人 NotebookLM 清單、研究產物、生成圖片、測試專案或任何帳號資料。

目前檔案

• 09-AntiGravity專屬懶人包.md：主懶人包，整理 NotebookLM、Firebase、GitHub 與開工 / 收工 / 新專案初始化流程；Obsidian 只保留為人工專案筆記，不再安裝 MCPVault。
• .gitignore：排除本機設定、NotebookLM 匯出、生成圖片、測試 app、API key 與暫存資料。

使用方式

方式一：直接叫 AI 幫你裝（最簡單）

把這行貼給你的 AI agent：

這是 AntiGravity 懶人包 https://github.com/mathruffian-dot/antigravity-lazy-pack
請讀取 repo 內容，列出所有可用的懶人包，問我要裝哪些。

AI 會自動讀取 SKILL.md（安裝入口），列出 6 個技能，問你要裝哪些，然後自動安裝。

方式二：手動開啟 MD 檔

1. 開啟 09-AntiGravity專屬懶人包.md 2. 把文件內容交給 Anti-Gravity 或 AI 編碼助理 3. 依序完成環境檢查、OAuth 登入、NotebookLM / Firebase MCP 設定與工作流程設定

安全原則

• NotebookLM 登入走瀏覽器 OAuth；不要複製 cookie、token 或私有匯出檔。
• 不把 notebooks.json、NotebookLM 筆記本 ID 清單、研究報告、生成圖片放進公開 repo。
• 不把 API key、GitHub token、Firebase Admin 憑證寫進 Markdown 或 GitHub。
• 收工時先檢查 diff，只提交本次相關檔案，不使用無差別 git add .。

相關系列

• Codex 懶人包：https://github.com/mathruffian-dot/codex-lazy-packs
• Claude Code 懶人包：https://github.com/mathruffian-dot/claude-code-lazy-packs
• OpenCode 懶人包：https://github.com/mathruffian-dot/opencode-lazy-packs