convex-best-practices 是做什麼的?
適用於建構可投入生產之 Convex 應用程式的指導原則,涵蓋函式組織、查詢模式、驗證、TypeScript 使用、錯誤處理,以及 Convex 設計哲學的「Zen of Convex」。
適用於建構可投入生產之 Convex 應用程式的指導原則,涵蓋函式組織、查詢模式、驗證、TypeScript 使用、錯誤處理,以及 Convex 設計哲學的「Zen of Convex」
這項技能提供一套全面的最佳實務與設計哲學,協助開發者使用 Convex(一種即時、無伺服器的後端平台)建構可投入生產的應用程式。它涵蓋了關鍵領域,例如用於改善可讀性的函式組織方式、用於最小化快取失效的查詢模式、輸入驗證策略、有效的 TypeScript 使用方式(包括聯合型別與類型取用)、結構化的錯誤處理,以及作為 Convex 基礎的核心設計原則(即「Zen of Convex」)。此技能支援任何引用其 SKILL.md 的 AI 代理工具(如 Claude Code 或 Cursor),為開發者提供可直接遵循的指引,幫助他們避開常見陷阱,並撰寫可維護、高效能且符合 Convex 慣例的程式碼。其內容源自實際開發經驗,以描述性段落和程式碼範例的形式呈現,使開發者能輕鬆應用這些概念。
npx skills add https://github.com/waynesutton/convexskills/tree/main/skills/convex-best-practices適用於建構可投入生產之 Convex 應用程式的指導原則,涵蓋函式組織、查詢模式、驗證、TypeScript 使用、錯誤處理,以及 Convex 設計哲學的「Zen of Convex」。
This repo contains 13 individual skills — each has its own dedicated page.
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.
Umbrella skill for all Convex development patterns. Routes to specific skills like convex-functions, convex-realtime, convex-agents, etc.
Building AI agents with the Convex Agent component including thread management, tool integration, streaming responses, RAG patterns, and workflow orchestration
How to create, structure, and publish self-contained Convex components with proper isolation, exports, and dependency management
Scheduled function patterns for background tasks including interval scheduling, cron expressions, job monitoring, retry strategies, and best practices for long-running tasks
Complete file handling including upload flows, serving files via URL, storing generated files from actions, deletion, and accessing file metadata from system tables
Writing queries, mutations, actions, and HTTP actions with proper argument validation, error handling, internal functions, and runtime considerations
External API integration and webhook handling including HTTP endpoint routing, request/response handling, authentication, CORS configuration, and webhook signature validation
Schema migration strategies for evolving applications including adding new fields, backfilling data, removing deprecated fields, index migrations, and zero-downtime migration patterns
Patterns for building reactive apps including subscription management, optimistic updates, cache behavior, and paginated queries with cursor-based loading
Defining and validating database schemas with proper typing, index configuration, optional fields, unions, and migration strategies for schema changes
Deep security review patterns for authorization logic, data access boundaries, action isolation, rate limiting, and protecting sensitive operations
Quick security audit checklist covering authentication, function exposure, argument validation, row-level access control, and environment variable handling
ElevenLabs text-to-speech with mac-style say UX.
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
Capture and automate macOS UI with the Peekaboo CLI.
Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".