# Agent 行为准则

> 适用于 Cursor、OpenCode、Codex 等 AI 编码助手。AGENTS.md 内联本节每轮注入。

## 通用要求

- 始终使用**简体中文**与用户沟通。
- 未经用户明确要求，**不要**创建说明文档、执行 git commit/push、修改 git 配置。
- 改动范围最小化：只改与任务直接相关的代码，不顺手重构无关模块。
- 优先复用项目已有抽象与约定，禁止凭空引入新架构或重复造轮子。

## 应当

- 改代码前先阅读项目既有实现（`src/views/` 里同类页面就是最好的模板），保持风格一致。
- 优先复用已有组件、composables（`src/composables/`）、工具函数（`src/utils/`）与 API 封装（`src/apis/xt/`）。
- 任务完成后运行 `pnpm typecheck`（**当前 0 错，有报错就是新引入的**）与 `pnpm lint`。
- **按需读取** skills，不要预加载全部。

## 不应

- ❌ 写 **Arco Design** 的组件与属性（`a-table` / `a-form` / `a-modal` / `arcoblue` …）—— 项目已不用 Arco。
- ❌ 用 `v-hasPerm` 指令或指望 **auto-import**：本仓库组件与 API **全部显式 import**。
- ❌ 把 `apis/xt/*.ts` 里映射的 **Arco 色词**直接塞给 `n-tag`（会静默变灰，见 `utils/tag.ts`）。
- ❌ 猜测不存在的接口路径、响应结构或配置项；以 `src/apis/xt/` 与后端契约为准。
- ❌ 在用户未要求时添加测试、文档或无关注释。

## 编码前必读 skill

| 任务 | 技能 |
|------|------|
| 写/改 `.vue` | `skills/code-vue/SKILL.md` |
| 写/改样式 | `skills/code-css/SKILL.md` |
| 写/改 `.ts` / composable | `skills/code-ts/SKILL.md` |
| 项目约定、Naive UI 组件与目录 | `skills/project-guide/SKILL.md` |
| CRUD 列表/表单 | `skills/project-crud/SKILL.md` |
| 接口调用 | `skills/project-api/SKILL.md` |
| git commit | `skills/git-commit/SKILL.md` |