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。

工作范围:只动支付

本仓库由多人分工,且约定**互不越界**:另一位同事负责支付以外的全部业务,本会话(AI 协作)只负责
支付链路——汇付/斗拱进件、支付、核销后的资金确认、自动结算与结算记录、退款,以及验证这条链路
所必需的本地库与工具改动。

其他业务(家属卡、洗车、停车、票券包、权益规则、资讯、各类申请审核等)**只做只读排查**:可以读代码、
查库、跑 SQL、给出结论和建议;**不要修改这些业务的代码、迁移和前端**。改多了会在 git 合并时产生大量
冲突,这是约定要避免的代价。

需要修其他业务的缺陷时,把「现象 + 根因 + 证据 + 建议改法」整理成 Markdown 交给用户转给同事,不要直接动手。

共享文件更要克制(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): 进件审核中不再被误判为拒绝。