# .agents/

本目录为 AI 编码助手规范的**唯一来源**（Single Source of Truth），适用于 Cursor、OpenCode、Codex 等工具。

> ⚠️ **2026-10 已整体重写**：PC 端从 **Gi Admin Pro + Arco Design Vue** 换成 **纯 Vue 3 + Naive UI**。
> 上一版 skills 里的 Arco 组件名（`a-table` / `a-form` / `a-modal`）、`v-hasPerm`、auto-import、
> Stylelint、Gi 的 `useTable/usePagination` **全部不再适用** —— 照着写会编译不过或静默失效。
> 唯一保留原样的是 `git-commit`（与框架无关）。

## 结构

```
.agents/
├── rules/
│   └── agent.md                # 唯一常驻规则（AGENTS.md 内联注入）
└── skills/                   # 按需加载
    ├── code-ts/SKILL.md          # TS 命名 / 导入 / 显式 import
    ├── code-vue/SKILL.md         # SFC 写法与模板约定
    ├── code-css/SKILL.md         # SCSS 与样式边界
    ├── project-guide/SKILL.md    # 技术栈 / 目录 / 七条最容易写错的约定
    ├── project-crud/SKILL.md     # 列表 + 表单的标准写法
    ├── project-api/SKILL.md      # 接口调用（没有 Mock）
    └── git-commit/SKILL.md       # 提交规范（与框架无关）
```

## 工具适配

| 工具 | 适配方式 |
|------|----------|
| Cursor | `AGENTS.md`（内联 behavior 规则 + 技能索引）+ `.agents/skills/`（按需） |
| OpenCode | `AGENTS.md` + `.agents/rules/` + `.agents/skills/` |
| Codex | `AGENTS.md` + `.agents/skills/` |