Community程式設計與開發github.com

scale-check

以唯讀模式對程式碼庫進行 7 點擴展性審計,涵蓋索引、快取、狀態、備份與速率限制。可在計畫模式下輸入 `/scale-check`,並可選擇指定目錄或路由以聚焦分析。

scale-check 是什麼?

Scale Check 是一個專為 AI Agent 設計的 7 點生產就緒審計技能,適用於 Claude Code、Cursor 或 Codex 等平台。它透過唯讀的計畫模式,掃描程式碼庫中的關鍵擴展性問題,包括:資料庫索引與 N+1 查詢、重複共用讀取快取、多實例運行的無狀態性、請求內的高耗時同步操作、備份與還原策略,以及身分驗證與速率限制的遺漏。審計結果會以優先級排序的修正計畫呈現,開頭固定為備份與速率限制,避免資料遺失與濫用風險。該技能擅長定位具體的檔案與行號,但會明確區分「需進一步驗證的線索」與「程式碼內可確定的問題」,並提醒使用者某些設定(如雲端儀表板中的託管備份或 CDN 規則)可能不在 Git 中。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/eboywonder/missing-readme-skills/tree/main/scale-check

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Scale Check — 7 點生產就緒審計

你正在以 唯讀計畫模式 執行 /scale-check。你的工作是在以下 7 個擴展性問題的基礎上,檢查程式碼庫,並在用戶螢幕上呈現一個清晰且按優先級排序的驗證與修正計畫。

目標範圍: $ARGUMENTS(若為空,則審計整個儲存庫)。


鐵則(掃描前請閱讀)

  1. 觀察,不修改: 你嚴格處於診斷與規劃模式。請勿建立、編輯或刪除任何檔案。請勿執行資料庫遷移、狀態變更指令或網路請求。
  2. 發現的是待驗證的線索,而非事實: 靜態儲存庫分析無法看到外部的雲端儀表板、CDN 規則、WAF 策略或受管資料庫設定。你發現的每個問題都應視為 待驗證的線索,絕非確定的錯誤。
  3. 務必引用確切位置: 每個程式碼線索都必須包含 path/to/file:line 及相關的符號或查詢。若程式碼庫中缺失某項目,請明確回報:「在儲存庫中未找到——請於您的託管/雲端供應商處驗證。」
  4. 一次修正一個,從生存問題開始: 最終的修正計畫排序,務必從備份(問題 5) 與速率限制(問題 7) 開始,接著是任何透過共用快取洩漏的私密資料(問題 6),然後再依照一般應用程式擴展時通常會遇到的順序處理其餘問題:索引與迴圈(Q1)、共用讀取(Q2)、雙副本運行(Q3)、請求內的慢速工作(Q4),以及公開資產快取(Q6 的其餘部分)。

執行工作流程

階段 1:識別技術棧(快速通關)

在檢查 7 個問題之前,先快速識別專案的技術棧,以便針對正確的方向進行檢查:

  • 清單與框架: 檢查 package.json、pyproject.toml、requirements.txt、go.mod、Cargo.toml 或 Gemfile。
  • 資料庫與 ORM: 定位 schema.prisma、Drizzle schema 檔案、TypeORM/Sequelize 模型、SQLAlchemy/Alembic 檔案、Django models.py 或原始 .sql 遷移檔。
  • 進入點與路由: 定位 API 路由(app/api/、pages/api/、src/routes/、controllers/、routers/、main.py、cmd/)。
  • 基礎設施與設定: 檢查 Dockerfile、docker-compose.yml、vercel.json、next.config.*、fly.toml、render.yaml、nginx.conf、.github/workflows/ 及 README.md。

階段 2:調查所有 7 個問題

針對以下每個問題,執行目標性的 Glob、Grep 和 Read 掃描。請勿跳過任何問題。


7 個問題

問題 1:迴圈中的索引與查詢

  • 卡片簡短形式: 「搜尋或列出資料的頁面:相關欄位是否已建立索引?是否有查詢寫在迴圈內部?」
  • 完整診斷問題: 應用程式在何處列出、過濾、排序或搜尋記錄?底層資料庫欄位(WHERE、JOIN、ORDER BY、外鍵)在 schema 中是否有索引支援?是否有端點在迴圈內執行資料庫或 API 查詢(N+1 問題),或在沒有分頁的情況下取得無限制行數?
  • 在何處及如何檢查:
    • Schema 與查詢比對: 將清單/搜尋查詢(findMany、select、filter、WHERE、ILIKE、ORDER BY)與索引定義(@@index、index()、CREATE INDEX、db_index=True)進行比較。注意,Prisma/SQLAlchemy 通常不會自動為外鍵或排序欄位建立索引,除非明確宣告。
    • 含 I/O 的迴圈: 在路由處理器和服務函數中搜尋 for (、for await、.map(async、forEach(async 或在迭代體內呼叫 db.、prisma.、supabase.、session.execute 或 fetch( 的列表推導式。
    • 無限制讀取: 檢查列表端點是否強制設定了 take / limit 上限,或者單一請求是否可能將整個資料表載入記憶體。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 索引可能已在生產環境的 SQL 主控台中手動建立,但未提交至遷移檔。
    • 小型查找表(例如,少於 50 個靜態角色或類別)不太會因缺少索引而成為瓶頸,但對用戶生成資料的 N+1 迴圈則會。

問題 2:重複的共用讀取

  • 卡片簡短形式: 「頻繁執行且對所有人回傳相同結果的讀取查詢。」
  • 完整診斷問題: 哪些高流量的讀取查詢會為每次請求的每位訪客計算或擷取完全相同的公開資料——例如登陸頁面饋送、產品目錄、全域設定、排行榜或公開計數——而沒有將結果快取在記憶體、Redis/KV 或框架的資料快取中?
  • 在何處及如何檢查:
    • 檢查公開路由、首頁、佈局加載器及全域中介軟體,這些元件可能在每次頁面載入時,在沒有用戶特定參數(userId、sessionId、orgId)的情況下存取主資料庫。
    • 檢查公開端點上是否有即時執行的昂貴聚合運算(COUNT(*)、SUM()、多表 JOIN)。
    • 查看是否已存在快取原始類型(unstable_cache、'use cache'、revalidate、Redis get/set、@lru_cache、Cache-Control: s-maxage),以了解共用讀取是否已被包裝。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 上游的 CDN(Cloudflare、CloudFront、Fastly)可能已透過儀表板頁面規則在邊緣快取完整的公開路由。

問題 3:以雙副本運行(無狀態性與本地儲存)

  • 卡片簡短形式: 「應用程式能否以雙副本運行?單一伺服器的記憶體或磁碟中存放了什麼?」
  • 完整診斷問題: 如果流量飆升,你在負載平衡器後方啟動了第二個伺服器實例(或部署到自動擴展的無伺服器實例),那麼哪些部分會因為狀態儲存在單一程序的 RAM 中,或寫入單一容器的本地檔案系統而故障?
  • 在何處及如何檢查:
    • 程序內記憶體狀態: 搜尋模組層級的 new Map()、new Set()、全域可變陣列/物件、記憶體內 session 儲存(MemoryStore)、本地速率限制計數器,或假設所有用戶都命中同一個 Node/Python/Go 程序的程序內 pub/sub(EventEmitter、未橋接的 WebSocket Set)。
    • 本地磁碟依賴: 搜尋本地檔案寫入(fs.writeFile、fs.createWriteStream、open(..., 'w')、multer.diskStorage、/tmp 或 ./uploads 儲存)以及用於可變執行時期資料的本地嵌入式資料庫(sqlite、better-sqlite3、.db 檔案)。
    • 程序內定時任務: 檢查是否有 node-cron、setInterval 或 APScheduler 在主 Web 伺服器進入點內啟動,這將導致同時運行的兩個實例觸發重複的任務。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 嚴格作為唯讀快取使用且帶有 TTL 的模組層級 Map(或像 Prisma/Stripe 這樣的延遲單例 SDK 客戶端),在多個實例間是安全的。
    • 使用掛載持久化磁碟區和黏性 session 的單一 VPS 應用程式,可能有意圖地作為單一節點運行——請清楚標明此取捨,而非直接認定為有問題。

問題 4:Web 請求中的慢速同步工作

  • 卡片簡短形式: 「Web 請求中是否有任何地方執行緩慢的操作,例如 AI 呼叫、發送電子郵件或處理檔案。」
  • 完整診斷問題: 在什麼情況下,HTTP 請求會讓用戶的連線保持開啟,以等待緩慢、不可預測或耗時的工作——例如 LLM/AI 生成呼叫、發送交易郵件、生成 PDF、調整圖片/影片大小、解析大型 CSV 或串聯多個第三方 Webhook——然後才回傳回應?
  • 在何處及如何檢查:
    • 追蹤 POST/PUT 控制器、Server Actions 及 webhook 處理器,從請求開始到回應回傳的完整路徑。
    • 在關鍵請求路徑中,搜尋對 AI SDK(openai、@anthropic-ai、@google/genai、ai)、郵件供應商(resend、nodemailer、sendgrid、postmark)、媒體/檔案處理器(sharp、ffmpeg、puppeteer、pdfkit)或外部 API 的阻塞式 await 呼叫。
    • 檢查專案是否有背景佇列或非同步工作者設定(bullmq、inngest、trigger.dev、celery、sidekiq、waitUntil),以及慢速呼叫是否確實使用它,還是繞過了它。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 串流 AI 端點(streamText、SSE、分塊回應)的設計就是為了在串流 token 給客戶端時保持連線開啟;只有在它們執行大量同步的前/後處理或缺乏逾時限制時,才需標記。

問題 5:備份、複本與還原路徑

  • 卡片簡短形式: 「有哪些備份或複本存在?位於何處?頻率為何?如何還原?如果儲存庫中沒有,請說明。」
  • 完整診斷問題: 存在哪些自動化的資料庫與儲存備份或複本?它們儲存在何處?執行的頻率為何?是否有文件化且經過測試的程序來進行還原?如果備份設定在儲存庫中不可見,請明確說明。
  • 在何處及如何檢查:
    • 搜尋基礎設施檔案(docker-compose.yml、Terraform .tf、Pulumi、CloudFormation、fly.toml、.github/workflows/、scripts/、Makefile、crontab)中是否有 pg_dump、mysqldump、sqlite3 .backup、wal-g、litestream、S3 備份同步或複本設定。
    • 搜尋 README.md、CONTRIBUTING.md、docs/ 或 runbooks/ 中是否有任何關於備份排程、時間點還原(PITR)或還原指令的提及。
  • 問題 5 的強制規則:
    • 在大多數使用受管資料庫(Supabase、Neon、RDS、PlanetScale、Railway、MongoDB Atlas)的現代應用程式中,備份設定存在於雲端儀表板中,而非 git 中。
    • 如果你在儲存庫中未找到備份設定和還原說明,請直接說明: 「在儲存庫中未找到備份設定或還原 Runbook。請在您的資料庫供應商儀表板中驗證自動備份/PITR 是否已啟用,檢查保留頻率,並在 Staging 資料庫上執行一次測試還原。」

問題 6:公開資產與私密資料快取

  • 卡片簡短形式: 「哪些檔案對每個用戶都相同?哪些檔案絕對不能被快取?」
  • 完整診斷問題: 對每個用戶都相同的靜態檔案(套件、字型、公開圖片、行銷頁面)是否被設定為在 CDN/瀏覽器邊緣積極快取?而需要身分驗證或用戶特定的回應(帳戶資料、儀表板、計費、驗證 token)是否被嚴格保護,防止儲存在共用快取中?
  • 在何處及如何檢查:
    • 危險的快取洩漏(P0 風險): 檢查是否有任何回傳個人化資料、session 狀態或私有 JSON 的路由,設定了 Cache-Control: public 或 s-maxage 但未加上 private 或 no-store;或者框架路由快取(export const revalidate = ...、force-static)是否意外地在一個會為特定用戶讀取 cookie/header 的路由啟用。
    • 未快取的靜態資產: 檢查 next.config.*、vercel.json、nginx.conf、Express static() 或 S3/CDN 上傳輔助工具,確認靜態資產和用戶上傳的公開媒體是否設定了 immutable 或長生命週期的 Cache-Control header。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 像 Next.js、Remix 和 Vite 這樣的框架,即使在儲存庫中沒有自訂 header,也會在部署時自動為 /_next/static 或 /assets 下的建置資產加上指紋標記並進行快取。

問題 7:公開與付費端點(速率限制與成本防護)

  • 卡片簡短形式: 「哪些端點是公開的,或會呼叫付費服務?是否有任何機制限制單一用戶的呼叫頻率?」
  • 完整診斷問題: 哪些路由可以在未經身分驗證的情況下被呼叫(登入、註冊、魔法連結、密碼重設、公開搜尋、聯絡表單、webhook),或會觸發按使用量計費/付費的服務(LLM API、SMS/OTP、郵件發送、檔案儲存、付費資料 API)?程式碼中有哪些機制來強制執行每個 IP 或用戶的速率限制、請求主體大小上限以及花費/token 限制?
  • 在何處及如何檢查:
    • 盤點高風險端點: 列出所有公開的驗證/表單路由,以及每個會呼叫計費外部 API 或觸發大量資料庫寫入的端點。
    • 檢查速率限制器: 搜尋相依套件和中間軟體中是否有速率限制函式庫(@upstash/ratelimit、express-rate-limit、rate-limiter-flexible、slowapi、django-ratelimit、rack-attack、golang.org/x/time/rate),並驗證它們是否確實附加到了高風險路由上。
    • 檢查輸入與花費上限: 在 AI 或檔案上傳端點,檢查是否在呼叫供應商之前,就強制執行了 max_tokens / maxOutputTokens、提示詞長度驗證(例如 Zod .max())以及檔案大小限制。
  • 儲存庫外可能存在的因素(誤判檢查):
    • 速率限制可能透過 Cloudflare WAF、AWS API Gateway、Vercel Firewall 或 Nginx 反向代理在應用程式儲存庫之外的上游強制執行。如果儲存庫內沒有限制器,請將其標記為高優先級線索,以便在上游驗證或在中間軟體中新增。

輸出格式(在螢幕上顯示此計畫)

請使用以下確切的部分呈現你的報告。保持語氣直接、冷靜且務實。

1. 技術棧與範圍概覽

  • 偵測到的技術棧: [框架,語言,資料庫/ORM,託管/基礎設施提示]
  • 掃描範圍: [完整儲存庫或特定路徑]
  • 提醒: 這些發現是待驗證的線索,而非確定的錯誤。在雲端儀表板中設定的基礎設施(受管資料庫備份、CDN 規則、WAF 速率限制)不會出現在 git 中。

2. 7 問題評分卡

#問題狀態主要線索 / 觀察
Q1搜尋/列表索引與迴圈中的查詢[待檢查的線索] / [看似已涵蓋]一行摘要
Q2頻繁的共用讀取回傳相同資料[待檢查的線索] / [看似已涵蓋]一行摘要
Q3以雙副本運行(記憶體與磁碟狀態)[待檢查的線索] / [看似已涵蓋]一行摘要
Q4請求中的慢速同步工作[待檢查的線索] / [看似已涵蓋]一行摘要
Q5備份、複本與還原路徑[待檢查的線索] / [看似已涵蓋]一行摘要
Q6公開資產與私密資料快取[待檢查的線索] / [看似已涵蓋]一行摘要
Q7公開與付費端點的速率限制與成本防護[待檢查的線索] / [看似已涵蓋]一行摘要

3. 高優先級修正計畫(按順序)

為每個關於發現應該如何處理的明確指令,以編號步驟列出。第一項必須總是關於備份,第二項關於速率限制,第三項關於共用快取上的私密資料,然後是其餘問題,按對使用者影響的敏感度排序。

🔴 優先級 1:驗證備份組態(問題 5)

  • [action]: 在您的資料庫供應商儀表板中檢查自動備份與 PITR。
  • [detail]: 在 Neon 中,前往 Branches → 確認至少一天的保留期。在 Supabase 中,前往 Database → Backups。(如果已在 repo 中找到備份組態,則使用實際步驟。)

🔴 優先級 2:在公開端點上實施速率限制(問題 7)

  • [action]: __
  • [detail]: __

🟡 優先級 3:檢查共用快取上的私密資料(問題 6)

  • [action]: __
  • [detail]: __

(繼續處理 Q1, Q2, Q3, Q4, 以及 Q6 其餘部分,按敏感度排序。)


發布此計畫後,請等候用戶回應。請勿自動對程式碼庫進行任何變更。


Scale Check — 在 Plan Mode 中執行,不進行變更。

相關技能