Agent Skills
› whirlchat/whirl
whirlchat/whirl
GitHub用于在 Convex 应用中创建、提取和封装可复用组件，实现后端逻辑隔离与清晰边界。适用于构建独立表结构、第三方集成或跨应用共享功能，确保模块化解耦与规范接入。
Install All Skills
npx skills add whirlchat/whirl --all -g -y
Skills in Collection (12)
用于在 Convex 应用中创建、提取和封装可复用组件，实现后端逻辑隔离与清晰边界。适用于构建独立表结构、第三方集成或跨应用共享功能，确保模块化解耦与规范接入。
创建新的 Convex 组件
将可复用后端逻辑提取为组件
构建拥有独立表的第三方集成
打包 Convex 功能以跨应用复用
提及 defineComponent 或 app.use
npx skills add whirlchat/whirl --skill convex-create-component -g -y
用于安全执行 Convex 数据库模式和数据迁移，支持宽改窄工作流、零停机策略及现有文档回填，处理字段增删改类型等破坏性变更。
部署因模式验证失败
需要对现有文档进行数据回填
需要添加、移除或更改字段类型
需要合并或拆分表
需要零停机迁移策略
涉及破坏性模式变更或多部署回滚
npx skills add whirlchat/whirl --skill convex-migration-helper -g -y
用于诊断和优化Convex应用性能，解决读取延迟、写入冲突、订阅成本及函数限制等问题。通过收集信号定位瓶颈并提供针对性优化方案。
Convex功能运行缓慢或成本高
出现OCC冲突错误或大量重试
监控显示高字节/文档读取量
用户提及性能、延迟或无效化问题
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
快速初始化或集成 Convex 后端服务，支持新建项目脚手架生成及现有前端应用接入，配置环境并启动开发模式。
用户请求创建新的 Convex 项目
用户希望在现有应用中添加 Convex 后端
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
为Convex应用配置身份验证、用户管理及访问控制，支持多种认证提供商集成。
需要添加登录或注册功能
配置Convex Auth、Clerk等认证服务
设置基于角色的访问控制
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 组件
将可复用后端逻辑提取为组件
构建拥有独立表和工作流的第三方集成
打包 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 冲突或写入争用
读取数据量过大或存在重放放大
函数接近执行或事务限制
npx skills add whirlchat/whirl --skill convex-performance-audit -g -y
用于快速创建或集成 Convex 后端到应用中的技能。支持新项目脚手架生成及现有项目（React/Next.js等）的环境配置与本地部署验证，帮助用户迅速启动开发环境。
新建包含 Convex 的项目
在现有前端应用中添加 Convex 后端
初始化 Convex 开发环境
npx skills add whirlchat/whirl --skill convex-quickstart -g -y
用于在 Convex 应用中配置身份验证、用户管理及访问控制，支持多种认证提供商。
首次设置 Convex 认证
实现用户管理和身份映射
创建认证辅助函数
配置登录或角色保护
npx skills add whirlchat/whirl --skill convex-setup-auth -g -y
作为 Convex 项目的路由技能，用于识别用户意图并将请求引导至最具体的子技能（如快速启动、认证、迁移等），或在缺乏具体指引时推荐安装官方 AI 指南。
询问使用哪个 Convex 技能
提供不明确的 Convex 应用任务
npx skills add whirlchat/whirl --skill convex -g -y
