chore: bootstrap independent git workflow
Some checks failed
release-smoke / macos-13 / x86_64-apple-darwin (push) Has been cancelled
release-smoke / ubuntu-latest / x86_64-unknown-linux-gnu (push) Has been cancelled
release-smoke / windows-latest / x86_64-pc-windows-msvc (push) Has been cancelled

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Paperclip CTO
2026-03-26 03:49:06 +00:00
commit 7424491944
60 changed files with 7793 additions and 0 deletions

View File

@@ -0,0 +1,51 @@
# 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