# AI 开发协作入口

开始修改、提交、推送或合并前，必须阅读并遵守 [仓库提交与合并规范](./仓库提交与合并规范.md)。准备更新生产服务器时，还必须阅读并遵守 [服务器部署规范](./服务器部署规范.md)。这些文件是本仓库多人协作的具体流程，不可仅凭本摘要跳过全文。

- 每个任务使用独立目录和唯一任务分支，默认前缀 `codex/`；不得共享目录并行编辑。
- 保留他人的未提交修改和已有提交，仅暂存本任务内容；不得清理或覆盖未知工作。
- 推送前同步远端，逐项检查最终差异并验证；被拒绝后先查明并合并更新，禁止任何形式的强推。
- 不改写已发布历史，不批量选择冲突的某一方；不明确的行为取舍需要负责人确认。
- 所有变更通过 PR 进入 `main`，不得直接推送主分支；默认由非提交者审核。仓库所有者或管理员明确授权某个 PR 合并时，该书面授权可以代替独立审核，但仍必须同步最新主分支、验证最终提交并保留授权记录。
- 不提交凭据、私钥、环境秘密或真实业务数据；不把合并授权当成生产部署授权。
- 新建或修改数据表、映射表、查询和同步任务时，必须按实际过滤、关联、排序和唯一性设计索引，用执行计划和有代表性数据验证负载；禁止无边界全表扫描、无节制并发和重复全量同步。
- 开发机器使用中央系统数据库和公网 TLS Redis，无需安装本地数据库；生产部署必须先将代码通过 PR 合入 `main`，并在 `/opt/cangku/deploy.lock` 锁内从服务器 Git 工作区快进拉取和验证。
- 最终交付报告实际分支、提交 SHA、验证结果及 PR 状态，不能将“已推送”报告为“已合并”。

这些文档不代表服务端保护已启用。任何 AI 工具无法自动读取规则时，由使用它的开发者主动提供全文。