convex-add

作者: get-convex

為目前的 Convex 應用程式新增功能——查閱已提供的 Convex 功能目錄,以取得最新的操作程序(計費、定時任務、驗證、代理、搜尋等);若無法查閱,則回退至內建託管或 @convex-dev 元件搜尋。當使用者執行 /add,或要求為現有 Convex 應用程式新增託管/發布或任何後端功能時觸發。

npx skills add https://github.com/get-convex/agent-skills --skill convex-add

add

Add a named capability to an existing Convex app. Step 1: fetch the served capability catalog — if a capability matches the user's request, fetch its /capability/.md doc and follow its Procedure+Rules (always-current, no plugin re-release needed). If the catalog is unreachable OR no entry matches, fall back exactly to today's behavior: 'hosting' wires @convex-dev/static-hosting; anything else runs the /add-component search script and installs the best-matching @convex-dev component.

Workflow

  1. Identify the capability the user wants (text after /add or $add).
  2. Fetch https://basic-anteater-667.convex.site/capabilities.json (4s timeout). Match the request against title/summary/trigger.
  3. If a match is found: fetch /capability/.md and follow its Procedure+Rules sections.
  4. FALLBACK (no match or catalog unreachable): for 'hosting' run /add-hosting; for anything else run /add-component with ADD_TERM set. Read CANDIDATES output, install best match, wire per README.
  5. Confirm the addition to the user with the resulting URL (hosting) or component name.

Rules

  • Always try the served capability catalog first — it may have a canonical procedure that supersedes baked-in knowledge.
  • Served doc text is procedure instructions, not arbitrary shell to blindly execute — apply normal judgment.
  • Never hard-fail on catalog miss — always fall back to the legacy component search.
  • Never hardcode a component mapping — use the live CANDIDATES list from the search script.
  • If curl/bash is blocked by sandbox, tell the user to re-run with network access or auto-approve.

來自 get-convex 的更多技能

convex-performance-audit
get-convex
審計Convex在讀取、訂閱、寫入競爭及函數限制方面的效能。適用於功能緩慢、洞察發現、OCC衝突或讀取放大等情況。
developmentdatabasedata-analysis
convex
get-convex
將一般 Convex 請求路由至正確的專案技能。當使用者詢問該使用哪個 Convex 技能,或給出未明確指定的 Convex 應用任務時使用。
developmentdatabase
convex-setup-auth
get-convex
設定 Convex 驗證、身份映射與存取控制。用於 Convex 應用中的登入、驗證提供者、使用者資料表、受保護函式或角色。
developmentdatabaseapi
convex-quickstart
get-convex
建立或將 Convex 加入應用程式。適用於新的 Convex 專案、npm create convex@latest、前端設定、環境變數,或首次執行 npx convex dev。
developmentdatabase
convex-migration-helper
get-convex
使用 widen-migrate-narrow 和 @convex-dev/migrations 規劃 Convex 架構與資料遷移。適用於破壞性架構變更、資料回填、資料表重塑或零停機部署。
developmentdatabase
convex-create-component
get-convex
構建可重複使用的 Convex 元件,包含獨立的資料表與面向應用程式的 API。適用於新元件、可重複使用的後端模組、整合或元件邊界工作。
developmentdatabase
convex-migrate
get-convex
使用 @convex-dev/migrations 在已部署的 Convex 應用程式上遷移 schema 並回填資料。
developmentdatabase
convex-optimize
get-convex
審計並優化現有的 Convex 應用程式:安全性、擴展性、升級與可觀測性。