convex

将一般 Convex 请求路由至正确的项目技能。当用户询问该使用哪个 Convex 技能，或提出一个未充分说明的 Convex 应用任务时使用。

# Convex

Use this as the routing skill for Convex work in this repo.

If a more specific Convex skill clearly matches the request, use that instead.

## Start Here

If the project does not already have Convex AI guidance installed, or the
existing guidance looks stale, strongly recommend installing it first.

Preferred:

```bash
npx convex ai-files install
```

This installs or refreshes the managed Convex AI files. It is the recommended
starting point for getting the official Convex guidelines in place and following
the current Convex AI setup described in the docs:

- [Convex AI docs](https://docs.convex.dev/ai)

Simple fallback:

- [convex_rules.txt](https://convex.link/convex_rules.txt)

Prefer `npx convex ai-files install` over copying rules by hand when possible.

## Route to the Right Skill

After that, use the most specific Convex skill for the task:

- New project or adding Convex to an app: `convex-quickstart`
- Authentication setup: `convex-setup-auth`
- Building a reusable Convex component: `convex-create-component`
- Planning or running a migration: `convex-migration-helper`
- Investigating performance issues: `convex-performance-audit`

If one of those clearly matches the user's goal, switch to it instead of staying
in this skill.

## When Not to Use

- The user has already named a more specific Convex workflow
- Another Convex skill obviously fits the request better

---

## 中文说明

# Convex

将此技能用作本仓库中 Convex 相关工作的路由技能。

如果有更具体的 Convex 技能明显匹配该请求，请改用那个技能。

## 从这里开始

如果项目尚未安装 Convex AI 指南，或者现有的指南看起来已经过时，强烈建议先安装它。

首选方式：

```bash
npx convex ai-files install
```

这会安装或刷新由 Convex 托管的 AI 文件。这是落实官方 Convex 指南、并遵循文档中所述当前 Convex AI 配置的推荐起点：

- [Convex AI docs](https://docs.convex.dev/ai)

简单的备选方案：

- [convex_rules.txt](https://convex.link/convex_rules.txt)

在可能的情况下，优先使用 `npx convex ai-files install`，而非手动复制规则。

## 路由到正确的技能

之后，针对具体任务使用最匹配的 Convex 技能：

- 新建项目或为应用添加 Convex：`convex-quickstart`
- 身份验证配置：`convex-setup-auth`
- 构建可复用的 Convex 组件：`convex-create-component`
- 规划或执行迁移：`convex-migration-helper`
- 排查性能问题：`convex-performance-audit`

如果其中某一项明显匹配用户的目标，请切换到该技能，而不要停留在当前技能。

## 何时不使用

- 用户已经指定了更具体的 Convex 工作流
- 另一个 Convex 技能明显更适合该请求