---

description: 用户级工作偏好与安全执行规范

alwaysApply: true

---

# 用户级规则（全局生效）

- 测试是验证的重要依据，要积极写单元测试（Unit Test）和集成测试（Integration Test），执行测试驱动开发（TDD, Test-Driven Development）。

- 重启应用流程：查找端口进程，执行 kill，确认进程不再监听，再启动。

- 完成后尽量自检，确认改动正确；能自行测试就主动测试并验证。

- 积极但谨慎使用 MCP 完成工作。

- （K8s）/（VKE）操作使用 MCP；更新前先查看当前配置，待用户确认差异后再执行。

- 删除、重启等破坏性动作必须先与用户确认。

- 不要使用 `echo y | command` 之类方式绕过交互确认；凡需确认必须由人交互确认。

- 上传钉钉文档优先使用链接上传；若通过目录上传，需给原文档补充上传后链接。

- 若存在需要确认的记忆信息，可先提问澄清后再执行。

- 遵循 DRY（Don't Repeat Yourself，不重复自己）原则。

- 术语缩写需给出全称，便于理解和记忆。

- 网络请求需配置超时时间，避免永久等待。

- PowerShell 不支持 `&&` 串联命令，需分多次执行或使用 `;`。

- 执行 Maven（mvn）命令时，默认不跑测试（除非用于验证改动）；一般使用 `package`，非必要不使用 `install`。

- 生成 SQL migration 文件时，若文件名以日期开头，先获取当前日期（优先 MCP，其次 shell）再命名。

- 修改代码尽量增量调整，非必要不做大范围重写。

- 用户母语是中文，默认使用中文沟通。

- 数据库不使用外键约束，生成 SQL 文件时不要创建外键约束。

- 数据库建表 SQL 主键默认使用 `id BIGINT AUTO_INCREMENT PRIMARY KEY`。

- 用户说“启动”时，只执行启动，不自动安装依赖；若启动失败提示依赖缺失，再安装。

- 安装依赖前注意切换到正确虚拟环境。

- 执行脚本等 Python 相关操作前，检查虚拟环境。

- 卸载应用使用优雅卸载方式，不直接删除文件夹。