LINE Bot × Google Sheets × Vercel 串接精靈
這個 Skill 幫你做什麼
把 LINE Official Account + Google Sheets + Gmail通知 + Vercel後端 這四塊串起來的基礎設施層。你只需要準備好自己的 Google Sheet 範本（不管裡面是菜單、報名表、預約表、物資申請表，內容完全由你自己設計），這個 Skill 會幫你的
AI 助理（Claude Code / Codex 等）走完剩下所有的串接工作：
- 建立 LINE Official Account 的 Messaging API channel
- 設定 Google Cloud OAuth（用真人 Gmail 帳號授權，不是 Service Account）
- 寫好 LINE Webhook：使用者傳一個關鍵字 → 自動複製你的 Google Sheet 範本 → 回傳連結
- 另一個關鍵字 → 鎖定試算表（改成唯讀）+ 寄 Email 通知你
- 部署到 Vercel，環境變數一次設定到位
- 內建「每週 OAuth Token 自動更新」工具，處理 Google 一個很多人不知道的坑（見下方）
這個 Skill 不會幫你做什麼
- 不會幫你設計 Google Sheet 的欄位、菜單、表單內容或商業邏輯
- 不會幫你寫 Apps Script 的驗證/鎖定規則
- 不會幫你做客製化的手機網頁表單
這些完全交給你自己決定跟設計 —— 這個 Skill 只負責把「LINE 觸發 → 你的 Sheet → Email 通知 → 上線在 Vercel」這條線接好、接穩。examples/ 資料夾裡附了一份完整的參考範例（一套真正上線在跑的訂餐系統），純粹展示「接好這層之後，
你自己可以在上面蓋出什麼」，不是這個 Skill 會主動幫你複製的東西。
這是誰做出來的
不是紙上談兵的架構文件 —— 這是一套真的在 production 上跑、服務真實使用者的訂餐系統，把實際踩過的坑整理沉澱出來的成果。裡面每一條「已知地雷」都是真的在正式環境爆炸過、修過、驗證過的，不是憑空想像的最佳實踐清單。
內建的實戰避坑知識
- Google OAuth「測試中」狀態下，refresh token 固定 7 天後失效 —— 跟有沒有在用完全無關，是 Google 的政策。很多人第一次遇到會以為是自己的程式碼壞了，其實是帳號驗證狀態的問題。Skill 附的自動化腳本可以把「重新授權」這件事
壓縮成一鍵完成（只剩一次瀏覽器點擊「允許」無法自動化，這是 OAuth 設計上刻意保留的人工步驟）。 - 個人 Gmail 帳號沒有 Service Account 儲存空間配額，而能繞過這個限制的「共用雲端硬碟」只有 Google Workspace 才有。很多人一開始會很自然地想用 Service Account，結果在複製檔案時撞到
storageQuotaExceeded才發現行不通。 - 試算表被丟進垃圾桶後，擁有者身份的 API 呼叫不會自然報錯 —— 不會變成「找不到檔案」，讀寫都正常運作，必須主動檢查
trashed欄位才抓得到,不然你的系統會以為那份資料還活著。 - Vercel 的 Sensitive 環境變數是「只寫不可讀」的 —— 連
vercel env pull都讀不回來,顯示[SENSITIVE]。要驗證有沒有設對,得靠打線上 API 驗證行為,不能靠讀值比對。 - LINE Webhook 對非 POST 請求／驗證請求一定要回 HTTP 200，不然 LINE 主控台的「Verify」跟正式訊息投遞都會失敗重試。
- Gmail 寄信一定要用「應用程式密碼」，不是帳號登入密碼，而且帳號要先開兩步驟驗證才申請得到 —— 用錯密碼類型時的錯誤訊息不會直接告訴你是這個原因。
適合誰用
- 想做「LINE觸發 → 產生一份個人化Google Sheet → 填完通知我」這種流程的任何場景：訂餐、揪團訂購、活動報名、會議室/場地預約、物資領用登記、值班/座位登記……欄位跟用途完全由你自己決定
- 已經會用 Claude Code / Codex 之類的 AI Coding Agent，想省掉「重新踩一次 OAuth 過期、Service Account 配額、Vercel 變數這些坑」的時間
- 想要拿到完整原始碼（Download 模式），自己接手維護，而不是被綁在別人代管的黑盒服務上
需要準備什麼
- 自己的 LINE 官方帳號 / LINE Developers 帳號
- 自己的 Google 帳號（個人 Gmail 即可）+ Google Cloud 專案
- 自己的 Vercel 帳號
- 一個已經設計好（或準備自己設計）的 Google Sheet 範本 —— 內容不限
使用流程
- 把這個 Skill 交給你的 AI Coding Agent（附完整的
SKILL.md與逐步指南guides/01~04） - Agent 會照著四份指南依序帶你完成：Google Cloud OAuth 設定 → LINE Developers 設定 → Vercel 部署 → 每週 Token 更新機制
- 全程你自己的帳號、自己的密鑰，不會有任何憑證經過第三方或這個 Skill 本身
- 部署完成後,傳 LINE 觸發關鍵字實測一次,收到 Google Sheet 連結就代表串接成功
常見問題
Q: 買了之後我的資料/憑證會不會經過 Capafy 或作者？
A: 不會。這是 Download 模式,買斷後是完整原始碼跑在你自己的 Vercel 帳號上,所有 API 金鑰都是你自己填到自己的 .env/Vercel 後台,不會被上傳或代管。
Q: 我完全不會寫程式可以用嗎？
A: 需要有在用 Claude Code / Codex 這類 AI Coding Agent 的基本經驗(能跟著它的指示操作終端機、瀏覽器)。這個 Skill 是給 Agent 讀的操作手冊,不是給人手動照抄的教學。
Q: 為什麼不幫我把 Google Sheet 的內容也設計好？
A: 每個人的表單需求差異太大(菜單、報名欄位、預約規則都不一樣),硬塞一套範本反而綁死你。這個 Skill ,都能穩定接上 LINE/Email/Vercel」這件事做對、做穩,把最容易踩雷、最需要實戰經驗的基礎設施層處理掉
