## Agent skills

### Issue tracker

Issue 以 Markdown 文件存放在 `.scratch/<feature-slug>/`。详见 `docs/agents/issue-tracker.md`。

### Triage labels

使用默认标签：`needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human`、`wontfix`。详见 `docs/agents/triage-labels.md`。

### Domain docs

采用单上下文布局：根目录 `CONTEXT.md`，ADR 位于 `docs/adr/`。详见 `docs/agents/domain.md`。

### 工作范围：按业务域分工，不要越界

本仓库由多人**按业务域分工**（支付链路一人，其余业务一人），彼此约定**互不越界**——越界改动会在
git 合并时产生大量冲突。本节适用于**所有**在仓库里工作的人和 AI 会话，与具体是谁无关。

- **只改用户本次指派范围内的代码、迁移和前端。** 范围以用户的说明为准；用户没说清、或任务看起来横跨
  多个业务域时，先问，不要自己扩大范围。
- **范围外的业务只做只读排查**：可以读代码、查库、跑 SQL、给出结论和建议，但不要直接改它的代码、
  迁移和前端。各业务域的代码位置见 `CONTEXT.md`。
- 需要修范围外的缺陷时，把「现象 + 根因 + 证据 + 建议改法」整理成 Markdown（放
  `.scratch/<feature-slug>/issues/`）交给用户转给该业务的负责人，不要直接动手。
- **迁移编号是全仓共享的**：新增迁移前先看 `talent-card-server/src/main/resources/db/migration/` 里当前
  的最大版本号，避免与他人撞号。
- **共享文件更要克制**（`talent-card-admin/src/api/admin.ts`、`src/router/index.ts`、
  `src/layouts/AdminLayout.vue`、`talent-card-server/src/main/resources/application.yml`、
  `AdminBusinessService.java`、`CONTEXT.md`）：只做自己范围内的**增量小改**，不要顺手重构或格式化
  别人的区域。

### 服务器测试与数据库

后端测试跑在共享的 MySQL 测试库上。跑测试用 `talent-card-server/scripts/run-server-tests.ps1`，
重置库用 `talent-card-server/scripts/reset-test-db.ps1`，并遵守：已执行的迁移只追加不修改、同一
checkout 一次只跑一个 Maven 构建、不要 `drop database`。详见 `docs/agents/testing.md`（含 3 项已知
基线失败，不要为证明它们"是既有的"而重复造 worktree）。

### Git 提交

提交信息一律用中文，沿用仓库既有风格：`type(scope): 中文摘要`，type 保留英文
（`feat`/`fix`/`refactor`/`docs`/`test`/`chore`），正文与说明也用中文。
只要求提交信息用中文；代码标识符、测试名、日志与错误信息保持英文。
示例：`fix(merchant): 进件审核中不再被误判为拒绝`。