规格和工单使用本仓库的本地 Markdown。见 docs/agents/issue-tracker.md。
.scratch/ 仅供本地临时使用，不纳入 Git。不得强制添加该目录，也不得移除其忽略规则。
使用五个默认分诊标签，以工单的 Status 字段记录。见 docs/agents/triage-labels.md。
使用 single-context 布局：根目录 CONTEXT.md 和 docs/adr/。见 docs/agents/domain.md。
新增或移动测试文件时，遵守单元测试说明中的目录约定。
- 默认在文件头使用显式 import，正文使用简单类名。
- 不得为了省略 import 修改或避免检查现有导入，而直接使用全限定类名。
- 仅在同名类型冲突，或语法要求必须限定名称时，使用全限定类名。
- 不使用通配符 import；移除本次修改产生的未使用 import。
- 完成修改后，检查新增及修改的代码，将无必要的全限定类名改为 import + 简单类名。
- C++、前端、后端默认使用增量编译，只构建本次改动模块及必要依赖，保留可用缓存和中间产物。
- 不例行执行 clean/rebuild；仅在缓存失效、构建配置变化或具体故障证据要求时做必要的全量构建，并说明原因。