Agent Skills
› whirlchat/whirl
whirlchat/whirl
GitHub用于创建可复用的 Convex 组件，通过隔离数据表、定义清晰边界和提供应用层包装器，实现后端逻辑封装与复用。
安装全部 Skills
npx skills add whirlchat/whirl --all -g -y
集合内 Skills (12)
用于创建可复用的 Convex 组件，通过隔离数据表、定义清晰边界和提供应用层包装器，实现后端逻辑封装与复用。
创建新的 Convex 组件
提取可复用后端逻辑
构建拥有独立表的第三方集成
用户提及 defineComponent 或 app.use
npx skills add whirlchat/whirl --skill convex-create-component -g -y
用于安全执行Convex数据库架构和数据迁移的助手，基于widen-migrate-narrow工作流处理破坏性变更、字段类型转换及零停机部署。
部署因架构验证失败
需要回填现有文档数据
添加或移除/更改字段类型
合并或拆分表结构
需要零停机迁移策略
npx skills add whirlchat/whirl --skill convex-migration-helper -g -y
用于诊断和优化 Convex 应用性能，涵盖热路径读取、写冲突、订阅成本及函数限制等问题。当应用变慢或资源消耗过高时触发。
Convex 应用响应缓慢或资源消耗高
出现 OCC 冲突错误或突变重试
CLI 报告高读取字节数或文档数
用户提及性能、延迟或无效问题
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
用于快速初始化 Convex 项目或向现有应用添加 Convex 后端。支持通过官方工具脚手架生成新项目，或在 React/Next.js 等应用中集成 Convex 并配置环境变量与 Provider。
新建包含 Convex 的后端全栈项目
在现有前端应用中集成 Convex 服务
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
为Convex应用配置身份验证，支持用户管理、身份映射及访问控制。涵盖Convex Auth、Clerk、Auth0等提供商集成，实现登录注册、保护查询/变更及基于角色的权限控制。
为Convex应用添加登录或注册功能
配置身份验证提供商（如Clerk, Auth0）
设置用户表和身份映射
实施基于角色的访问控制
npx skills add whirlchat/whirl --skill convex-setup-auth -g -y
Convex工作区的路由技能，用于识别并引导至具体的Convex子任务（如快速开始、认证、组件构建等），优先推荐安装官方AI指南。
用户明确调用convex技能
询问使用哪个Convex工作流或技能
表示正在开发Convex应用但未指定具体任务
npx skills add whirlchat/whirl --skill convex -g -y
用于在 Convex 应用中创建可复用的后端组件，支持隔离数据表与 API。适用于新建组件、逻辑提取或第三方集成封装，强调清晰的边界与跨应用复用能力。
创建新的 Convex 组件
将后端逻辑提取为独立组件
构建拥有独立数据表的第三方集成
封装功能以跨多个应用复用
npx skills add whirlchat/whirl --skill convex-create-component -g -y
用于安全执行Convex数据库模式和数据迁移的助手，支持宽改窄策略、数据回填及零停机发布，处理破坏性变更。
需要向现有表添加必填字段
修改现有字段类型或结构
拆分或合并数据表
重命名或删除字段
从嵌套数据结构迁移至关系型数据
npx skills add whirlchat/whirl --skill convex-migration-helper -g -y
用于诊断和修复 Convex 应用的性能问题，涵盖读取、订阅、写入冲突及函数限制。通过收集信号并路由至对应参考文档，解决慢速功能、OCC 冲突或读取放大等问题。
Convex 页面或功能运行缓慢
Insights 报告高读取量或 OCC 冲突
出现 OCC 冲突错误或过多重试
订阅数量高或 UI 更新缓慢
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
用于快速创建或集成 Convex 后端服务。支持新建项目脚手架生成、现有应用添加 Convex 依赖及配置，提供本地开发环境部署与验证流程。
新建 Convex 项目
在现有应用中集成 Convex
Convex 环境初始化
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
用于在 Convex 应用中配置身份验证、用户管理及访问控制。支持首次设置、集成多种认证提供商（如 Clerk、Auth0）及创建保护函数，实现安全的登录与权限管理。
首次为 Convex 应用设置认证
需要集成特定认证提供商（Clerk, Auth0等）
配置用户表或身份映射
创建受保护的函数或角色权限
npx skills add whirlchat/whirl --skill convex-setup-auth -g -y
作为 Convex 工作流的入口路由技能，用于识别用户意图并将请求分发至具体的子技能（如初始化、认证、组件构建等），同时推荐安装官方 AI 指导文件。
用户询问应使用哪个 Convex 技能
用户提出未明确具体步骤的 Convex 应用任务
npx skills add whirlchat/whirl --skill convex -g -y
