Agent Skills
› whirlchat/whirl
whirlchat/whirl
GitHub用于在Convex应用中创建可复用组件，通过隔离数据表、定义清晰边界和封装API来解耦业务逻辑。适用于构建第三方集成或提取后端逻辑。
Install All Skills
npx skills add whirlchat/whirl --all -g -y
Skills in Collection (12)
用于在Convex应用中创建可复用组件，通过隔离数据表、定义清晰边界和封装API来解耦业务逻辑。适用于构建第三方集成或提取后端逻辑。
创建新的Convex组件
将可复用的后端逻辑提取为组件
构建拥有独立表的第三方集成
打包Convex功能以供复用
npx skills add whirlchat/whirl --skill convex-create-component -g -y
用于在 Convex 数据库中安全执行 Schema 和数据迁移的助手。通过 widen-migrate-narrow 工作流处理破坏性变更，支持零停机部署、字段增删改及数据回填，解决部署时的 Schema 验证失败问题。
Convex 部署因 Schema 验证失败而中断
需要对现有数据进行字段类型变更或结构重组
需要执行零停机策略的数据迁移和回填
用户提及破坏性 Schema 变更或多阶段发布
npx skills add whirlchat/whirl --skill convex-migration-helper -g -y
用于诊断和优化 Convex 应用性能，涵盖读取热点、写入冲突、订阅成本及函数限制。当应用变慢、资源消耗高或出现错误时触发，通过收集信号并路由至对应参考文件进行针对性修复。
Convex 功能运行缓慢或成本高
CLI insights 显示高字节/文档读取或 OCC 冲突
用户报告延迟、读取放大或无效化问题
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
用于快速初始化或集成 Convex 数据库服务，支持新项目脚手架生成及现有应用接入，涵盖模板选择、环境配置和开发循环启动。
初始化新的 Convex 项目
在现有应用中添加 Convex 后端
用户请求设置 Convex 或添加后端
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
用于在 Convex 应用中配置身份验证，支持多种提供商，实现用户管理、身份映射及基于角色的访问控制。
添加登录或注册功能
配置身份验证提供商
设置用户表与身份映射
实施基于角色的访问控制
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数据库模式和数据迁移，支持宽改窄策略、零停机发布及数据回填。用于处理破坏性变更如字段类型修改或表结构重组，确保部署安全。
Convex数据库模式变更
数据回填与迁移
零停机部署
npx skills add whirlchat/whirl --skill convex-migration-helper -g -y
用于诊断和修复 Convex 应用的性能问题，包括读取延迟、订阅成本、写入冲突及函数限制等场景。
Convex页面或功能响应缓慢
Insights报告高读取量或OCC冲突
出现OCC冲突错误或过多重试
订阅数量过高或UI更新缓慢
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
快速创建或集成 Convex 后端到应用，支持新项目脚手架生成及现有项目配置，涵盖模板选择、依赖安装、本地部署验证及开发环境启动。
初始化新的 Convex 项目
在现有前端应用中添加 Convex
搭建 Convex 原型
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
用于在 Convex 应用中设置身份验证、用户管理及访问控制。支持首次配置、集成多种认证提供商（如 Clerk、Auth0）及创建受保护函数，提供完整的鉴权流程指导。
Convex 应用首次身份验证配置
集成第三方认证提供商
设置用户表与身份映射
创建受保护的函数或角色权限
npx skills add whirlchat/whirl --skill convex-setup-auth -g -y
Convex 项目的路由技能，用于识别用户意图并引导至具体的 Convex 子技能（如快速启动、认证、组件开发等），同时推荐安装官方 AI 指导文件。
询问使用哪个 Convex 技能
提供不明确的 Convex 应用任务
npx skills add whirlchat/whirl --skill convex -g -y
