# Contribution Guide

## 分支和提交

- 每个需求使用独立分支，推荐命名：`domain/<domain>/<feature>` 或 `core/<feature>`。
- 一个提交只处理一个领域或一个公共契约变更，不把跨领域格式调整混入领域功能提交。
- 公共契约变更必须先由集成人员评审，再通知所有受影响领域升级。

## 领域成员修改范围

领域成员默认只修改 `domains/<domain>/`。确需修改 `contracts/`、`platforms/` 或 `src/cognitive_agent/` 时，应单独提交变更请求并说明兼容性、迁移步骤和测试影响。

## 合并前最低要求

1. 公共 Schema 校验通过。
2. 领域参数 Schema 和语义校验通过。
3. 配置到 `CommandPlan` 的编译为确定性输出，并有 golden test。
4. dry-run 测试覆盖正常值、边界值、越界值、超时和执行器拒绝。
5. 真实车辆测试只能使用已审批平台配置，并附脱敏后的执行报告。
6. 不提交密钥、车辆隐私数据、运行产物或本地 DBC 临时副本。