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): 进件审核中不再被误判为拒绝。