Vibe Coding 技術債完整指南

我想做一個 [你要什麼]。
在開始寫任何 code 之前，請你先：
1. 問我幾個關鍵問題（技術選擇、邊界情況、資料流）
2. 幫我規劃整體架構（資料夾結構、技術棧）
3. 列出建議的開發順序（先做什麼再做什麼）
4. 告訴我可能會遇到的問題
5. 等我確認了再開始寫

# 專案名稱
一句話描述這個專案
## 技術棧
- 框架：Next.js 15
- 資料庫：Supabase
- 樣式：Tailwind
## 資料夾結構
- src/app/ — 路由
- src/components/ — 共用元件
- src/lib/ — 商業邏輯
## 指令
- npm run dev — 本地開發
- npm run test — 跑測試
## 規則
- 所有資料庫操作都走 src/lib/db/
- 不要自己加新的套件，先問我
- 錯誤處理要帶上下文，不能靜默吞掉
- 改完 code 要跑 typecheck
## 不要做的事
- 不要用 any 型別
- 不要繞過 Supabase RLS
- 不要直接 commit 到 main

先進入 Plan Mode，不要動 code。
讀完 [相關檔案] 之後回答我：
1. 這個功能需要改哪些檔案？
2. 資料從用戶操作到資料庫的完整流程是什麼？
3. 哪裡可能會出錯？
4. 現有的 codebase 有什麼既有的寫法要遵循？
列出計劃，等我確認再開始。

等一下，看看你剛寫的 [檔案]。
跟 [另一個類似功能的檔案] 比較一下，寫法一致嗎？
如果不一致，哪種寫法應該是標準？為什麼？

我注意到你剛才也改了 [X]，但我只要你改 [Y]。
那個改動是必要的嗎？如果不是，還原它。
我們只改這次任務需要的東西。

把剛才做的 commit，訊息要說明「為什麼」改，不只是「改了什麼」。
格式：feat: / fix: / refactor:
不要 commit 任何還沒完成的程式碼或註解掉的 code。

做一次技術債審查，先不要改任何東西。
檢查：
1. 寫法一致性：錯誤處理、資料庫操作、API 回應，每種有幾種不同寫法？超過 3 種 = 有問題
2. 理解度：超過 50 行的函式或超過 300 行的檔案，你能用白話解釋每個在幹嘛嗎？
3. 測試：哪些重要功能沒有測試？哪些測試只測了正常情況沒測邊界？
4. 死碼：哪些函式或檔案沒有被用到？
5. 安全：所有用戶輸入的地方都有驗證嗎？
6. 套件：跑 npm audit 看有沒有已知漏洞
給我一份優先順序清單：高/中/低，先不要動手修。

你現在是資深的全端工程師
review 我的 code
包含前端、後端的程式碼是否寫法跟邏輯一致
給我 1-10 分
並告訴我哪裡會拉高我的成本跟未來不好維護

我們要重構 [哪個模組]。
動手之前：
1. 先跑現有的測試，確認全部通過
2. 如果測試不夠，先寫新的測試記錄目前的行為
3. 然後才開始改，一次只改一件事
4. 每改一件就跑一次測試
5. 如果有任何之前通過的測試壞了，停下來告訴我

跑一次健康檢查：
1. 套件更新狀態：npm outdated，標記落後 2 個大版本以上的
2. 型別安全：npx tsc --noEmit，列出所有型別錯誤
3. 程式碼品質：npm run lint，列出警告和錯誤
4. 測試狀態：npm test，通過率和不穩定的測試
5. 死碼：有沒有沒被用到的 export
一段話總結：這個 codebase 是健康、退化、還是危機？

扮演安全審查員，讀 [auth, API, 資料庫相關檔案]。
檢查：
1. 所有用戶輸入的地方都有驗證嗎？
2. 有沒有寫死的密鑰或 API key？
3. SQL 查詢都有參數化嗎？
4. 有沒有辦法繞過登入驗證？
5. 錯誤訊息有沒有洩露敏感資訊？
6. 跑 npm audit 看已知漏洞
每個發現：嚴重程度 + 檔案位置 + 修復建議
先不要修，給我報告就好。