Copilot instructions

1# OPC-Starter Copilot 指令
2 
3## 技术栈
4 
5React 19.1 · TypeScript 5.9 (strict) · Vite 7.1 · Tailwind CSS 4.1 · Supabase 2.80 · Zustand 5.0
6 
7## 关键规则
8 
9- 使用 Tailwind CSS **v4** 语法，禁止 `bg-opacity-*`、`bg-gradient-to-*` 等 v2/v3 写法
10- 数据操作通过 `DataService`，禁止直接导入 `@/lib/supabase/client`
11- SQL 变更集中到 `app/supabase/setup.sql`
12- 新文件必须在顶部添加 JSDoc 文件头注释
13- `@typescript-eslint/no-explicit-any: error`，避免 `any` 类型逃逸
14 
15## 代码路径别名
16 
17`@/*` → `src/*`
18 
19## 分层约束
20 
21```
22pages → components → hooks → stores → services → lib
23```
24 
25上层可导入下层，禁止逆向依赖。`pages/`、`components/`、`hooks/` 禁止直接导入 `@/lib/supabase/client`。
26 
27## 质量门禁
28 
29```bash
30npm run ai:check   # lint + format + type-check + coverage + build
31npm run test        # Vitest 单元测试
32npm run type-check  # TypeScript 类型检查
33```
34 
35## 文档参考
36 
37- `docs/Architecture.md` — 系统架构
38- `docs/API.md` — AI Assistant API
39- `docs/CONVENTIONS.md` — 编码规范
40- `docs/DESIGN_TOKENS.md` — 设计令牌
41