1.7 KiB
1.7 KiB
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