Communitygithub.com

waynesutton/convex-best-practices

適用於建構可投入生產之 Convex 應用程式的指導原則,涵蓋函式組織、查詢模式、驗證、TypeScript 使用、錯誤處理,以及 Convex 設計哲學的「Zen of Convex」

convex-best-practices 是什麼?

這項技能提供一套全面的最佳實務與設計哲學,協助開發者使用 Convex(一種即時、無伺服器的後端平台)建構可投入生產的應用程式。它涵蓋了關鍵領域,例如用於改善可讀性的函式組織方式、用於最小化快取失效的查詢模式、輸入驗證策略、有效的 TypeScript 使用方式(包括聯合型別與類型取用)、結構化的錯誤處理,以及作為 Convex 基礎的核心設計原則(即「Zen of Convex」)。此技能支援任何引用其 SKILL.md 的 AI 代理工具(如 Claude Code 或 Cursor),為開發者提供可直接遵循的指引,幫助他們避開常見陷阱,並撰寫可維護、高效能且符合 Convex 慣例的程式碼。其內容源自實際開發經驗,以描述性段落和程式碼範例的形式呈現,使開發者能輕鬆應用這些概念。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/waynesutton/convexskills/tree/main/skills/convex-best-practices

在你喜歡的 AI 中提問

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

說明文件

convex-best-practices 是做什麼的?

適用於建構可投入生產之 Convex 應用程式的指導原則,涵蓋函式組織、查詢模式、驗證、TypeScript 使用、錯誤處理,以及 Convex 設計哲學的「Zen of Convex」。

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

waynesutton/avoid-feature-creep

Prevent feature creep when building software, apps, and AI-powered products. Use this skill when planning features, reviewing scope, building MVPs, managing backlogs, or when a user says "just one more feature." Helps developers and AI agents stay focused, ship faster, and avoid bloated products.

waynesutton/convex

Umbrella skill for all Convex development patterns. Routes to specific skills like convex-functions, convex-realtime, convex-agents, etc.

waynesutton/convex-agents

Building AI agents with the Convex Agent component including thread management, tool integration, streaming responses, RAG patterns, and workflow orchestration

waynesutton/convex-component-authoring

How to create, structure, and publish self-contained Convex components with proper isolation, exports, and dependency management

waynesutton/convex-cron-jobs

Scheduled function patterns for background tasks including interval scheduling, cron expressions, job monitoring, retry strategies, and best practices for long-running tasks

waynesutton/convex-file-storage

Complete file handling including upload flows, serving files via URL, storing generated files from actions, deletion, and accessing file metadata from system tables

waynesutton/convex-functions

Writing queries, mutations, actions, and HTTP actions with proper argument validation, error handling, internal functions, and runtime considerations

waynesutton/convex-http-actions

External API integration and webhook handling including HTTP endpoint routing, request/response handling, authentication, CORS configuration, and webhook signature validation

waynesutton/convex-migrations

Schema migration strategies for evolving applications including adding new fields, backfilling data, removing deprecated fields, index migrations, and zero-downtime migration patterns

waynesutton/convex-realtime

Patterns for building reactive apps including subscription management, optimistic updates, cache behavior, and paginated queries with cursor-based loading

waynesutton/convex-schema-validator

Defining and validating database schemas with proper typing, index configuration, optional fields, unions, and migration strategies for schema changes

waynesutton/convex-security-audit

Deep security review patterns for authorization logic, data access boundaries, action isolation, rate limiting, and protecting sensitive operations

waynesutton/convex-security-check

Quick security audit checklist covering authentication, function exposure, argument validation, row-level access control, and environment variable handling

相關技能