52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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
|