init

2026-07-30 08:45:38 +08:00
commit 25b24ac4cd
1333 changed files with 170092 additions and 0 deletions
@@ -0,0 +1,21 @@
+# 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 临时副本。
+