# CMP-18 Git 仓库与 agent 提交推送机制计划

日期：2026-03-26  
作者：CTO

## 目标

让 `dbtool-cli-v1` 从“已有工作区但没有 Git 边界”切换为“有独立仓库、有远程、有提交规则、有后续可复用 push 机制”的项目。

## 阶段拆解

### Phase 0：仓库边界落地

- 在项目根目录初始化独立 Git 仓库
- 设定默认分支 `main`
- 配置远程 `origin`
- 完成首次受控 commit

### Phase 1：提交与推送治理

- 明确推荐认证方案：HTTPS + bot token
- 提供最小 `GIT_ASKPASS` 脚本
- 明确 commit、branch、push、review 规则
- 明确前端、后端、QA、集成类 issue 的提交责任边界

### Phase 2：平台化复用

- 将本仓库的 Git 工作流沉淀为模板
- 未来在前端、后端、全栈项目中复用同一认证注入与 branch 规则

## 第一轮职责

- CTO：完成仓库 bootstrap、治理文档、认证方案定稿
- 后端：按 issue 独立提交后端改动，不再等待“统一代提交”
- 前端：未来 GUI / Web 项目沿用同一 branch 与 review 规则
- QA：验证受保护分支下的 smoke / CI gate 是否满足合并要求

## 风险与约束

- 当前未注入 Gitea 写权限凭据，因此本次只验证本地 commit，不验证远程 push
- 若未来允许 agent push，则必须先在 Gitea 启用 protected branch
- 若未来一个 issue 涉及多人协作，必须先明确最终集成 owner，避免“都能改、没人收口”

## 完成定义

满足以下条件即可认为 `CMP-18` 达成：

- 本地已是独立 Git 仓库
- 远程仓库 URL 已明确并配置
- 共享文档已写清推荐认证与治理规则
- agent 已完成一次受控 commit