技能 convex-migration-helper
📦
convex-migration-helper
內容修訂 r1 安全 ⚙️ 外部命令🌐 網路存取
規劃安全的 Convex 資料遷移
破壞性的 Convex schema 變更可能導致部署失敗或損害生產資料。此技能會引導安全推出、批次回填、試跑與驗證。
支援: Claude Codex Code(CC)
使用我的智慧代理安裝
將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。
智能體請求
Review the Skillstore skill "convex-migration-helper" from https://skillstore.io/skills/get-convex-convex-migration-helper.md and its manifest at https://skillstore.io/api/skills/get-convex-convex-migration-helper/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。
測試它
正在使用「convex-migration-helper」。 使用者資料表需要為既有帳戶新增必填的 role 欄位。
預期結果:
- 部署放寬後的 schema，讓 role 成為選填。
- 先進行試跑，再批次回填缺少的 roles。
- 在將 role 設為必填前，驗證沒有帳戶仍未遷移。
正在使用「convex-migration-helper」。 團隊資料表正從布林值 plan 旗標改為 plan enum。
預期結果:
- 新增新的 plan 欄位，同時保留舊旗標為選填。
- 在轉換期間，以新格式寫入新文件。
- 只有在驗證通過後，才移除舊的讀取端與欄位。
正在使用「convex-migration-helper」。 大型資料表遷移在本機測試期間持續逾時。
預期結果:
- 使用 migrations 元件，而不是收集整個資料表。
- 針對大型文件或高寫入流量降低批次大小。
- 監控遷移狀態，並在失敗後從已儲存的 cursor 重試。
安全審計
安全v4 • 2026/7/5 開啟版本化報告
All static findings were adjudicated as false positives. The apparent SQLite and shell execution findings are Convex ctx.db examples and Markdown backticks in documentation. No prompt injection, data exfiltration intent, or hidden malicious behavior was found in the reviewed skill files.
5
已掃描檔案
569
分析行數
0
複核項目
0
已忽略的誤報
風險因素
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/get-convex-convex-migration-helper/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/get-convex-convex-migration-helper.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>學術引用 (APA · BibTeX · CFF)
APA 引用
get-convex. (2026). convex-migration-helper security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4BibTeX 引用
@techreport{get-convex-get-convex-convex-migration-helper-2026,
author = {get-convex},
title = {convex-migration-helper security audit report (audit version 4)},
institution = {Skillstore},
year = {2026},
number = {4},
url = {https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "convex-migration-helper security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
- name: "get-convex"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4"
identifiers:
- type: other
value: "skillstore:get-convex-convex-migration-helper:audit:4"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高 55
架構
85
可維護性
87
內容
68
社群
83
規範符合度
你可以打造什麼
安全新增必填欄位
規劃先新增選填欄位、回填既有文件，並在驗證後再將欄位設為必填的推出流程。
準備零停機推出
設計分階段部署，讓應用程式程式碼在遷移期間同時處理舊與新的資料格式。
重構既有資料模型
規劃欄位刪除、型別變更、資料表拆分、孤立資料清理與遷移完成檢查的步驟。
試試這些提示
識別是否需要遷移
審查這項 Convex schema 變更，並告訴我是否需要資料遷移。說明部署順序與主要風險。
規劃必填欄位推出
為在既有 Convex 資料表新增必填欄位，建立 widen-migrate-narrow 計畫。包含驗證與回復注意事項。
設計批次遷移
協助我為這個資料表設計批次 Convex 遷移，包含試跑、狀態監控與安全的批次大小設定。
稽核生產推出
稽核這份 Convex 遷移計畫的生產安全性。檢查 schema 放寬、雙重讀取或寫入、試跑涵蓋範圍與完成檢查。
最佳實務
- 在處理生產資料前先放寬 schema。
- 在生產執行前先試跑並檢查狀態。
- 在收窄 schema 前，驗證每份文件都已遷移。
避免
- 在既有文件尚未回填前，就將欄位設為必填。
- 在大型資料表上使用 collect，而不是批次遷移。
- 在讀取端和寫入端停止使用前，就刪除舊版欄位。
常見問題
什麼是 widen-migrate-narrow？
這是一種分階段工作流程。先允許舊資料和新資料，接著遷移記錄，最後要求新的資料形狀。
此技能會自動執行遷移嗎？
不會。它提供計畫與範例。你自行決定何時執行命令，並應先審查它們。
我什麼時候應該使用 @convex-dev/migrations？
用於非簡單的回填、大型資料表、可續行作業、試跑與進度監控。
它能協助零停機嗎？
可以。它會說明分階段部署、雙重讀取、雙重寫入，以及在收窄 schema 前的驗證。
它支援小型資料表遷移嗎？
可以。它會描述小型資料表在什麼情況下可接受使用單一內部 mutation。
上生產前我應該做什麼？
備份重要資料、進行試跑、檢查遷移狀態，並驗證剩餘未遷移的文件。
開發者詳細資訊
作者
get-convex授權
MIT
Skillstore 修訂
r1
版本提示
作者未聲明版本。
引用
30c73eac2afe762f6aa9c4553158769369d47351
維護新鮮度
2026/7/18
使用量
3 次下載 · 88 次瀏覽
檔案結構