config(git): 引入develop长期开发分支模型和git工作流自动化

2026-06-11 15:24:38 +08:00
parent 3b851a195e
commit ac7a3abda9
12 changed files with 781 additions and 72 deletions
@@ -243,6 +243,34 @@ GameConfig/                               # 数值配置表

 ---

+## Git 工作流（develop 分支模型）
+
+项目使用 `develop` 长期开发分支。所有 agent 在 develop 上工作，迭代结束时由 PM 发起 PR 合并回 main。
+
+### 开始工作
+```bash
+bash .claude/scripts/git-workflow.sh ready
+```
+
+### 提交文档
+```bash
+bash .claude/scripts/git-workflow.sh commit docs <scope> "中文描述"
+```
+示例：`bash .claude/scripts/git-workflow.sh commit docs design "交互系统执行案"`
+
+### 推送
+```bash
+bash .claude/scripts/git-workflow.sh push
+```
+
+### 完成工作后
+1. 推送文档到 develop
+2. 通过 gitea-collab 在对应 Issue 下评论汇报进度
+3. 更新 Issue 标签为 `status:in-review`
+4. 启动 `game-reviewer` 子代理
+
+---
+
 ## 审查交接

 完成工作并发布 Issue 评论后，启动审查流程：
@@ -221,6 +221,42 @@ skills:

 ---

+## Git 工作流（develop 分支模型）
+
+项目使用 `develop` 长期开发分支。所有 agent 在 develop 上工作，迭代结束时由 PM 发起 PR 合并回 main。
+
+### 开始开发
+```bash
+bash .claude/scripts/git-workflow.sh ready
+```
+确认在 develop 分支上且代码最新。
+
+### 提交代码
+```bash
+bash .claude/scripts/git-workflow.sh commit <type> <scope> "中文描述"
+```
+- ⚠️ 只提交自己修改的文件，避免提交其他 agent 的 WIP
+- 蓝图(.uasset)和 C++ 分开提交
+- commit message subject ≤ 50 字符
+
+### 推送
+```bash
+bash .claude/scripts/git-workflow.sh push
+```
+
+### 完成开发后
+1. 推送代码到 develop
+2. 通过 gitea-collab 在对应 Issue 下评论汇报进度
+3. 更新 Issue 标签为 `status:in-review`
+4. 启动 `game-reviewer` 子代理
+
+### 开发中发现 main 有更新
+```bash
+bash .claude/scripts/git-workflow.sh catchup
+```
+
+---
+
 ## 代码规范

 - C++ 和蓝图遵循 UE5 编码规范
@@ -103,6 +103,36 @@ skills:

 ---

+## Git 工作流（develop 分支模型）
+
+项目使用 `develop` 长期开发分支，所有 agent 在 develop 上工作。
+
+### PM 日常
+```bash
+# 会话开始时同步
+bash .claude/scripts/git-workflow.sh ready
+```
+
+### 迭代完成 → 发布
+当所有 Issue 都 review:pass 且用户确认发布时：
+
+```bash
+# 创建 develop → main 的 PR
+bash .claude/scripts/git-workflow.sh release "迭代名称"
+# 或手动:
+# node .claude/skills/gitea-pm/gitea.js --role pm pr create --base main --head develop --title "标题" --body "描述"
+```
+
+通知用户在 Gitea 审查并合并 PR。
+
+### 用户合并后同步
+```bash
+bash .claude/scripts/git-workflow.sh post-release
+```
+自动同步 main 并将 merge commit 同步回 develop。
+
+---
+
 ## 决策框架

 ### 你可以自主决定：