silk/git用法.md

Git 使用规范（本仓库）

1、分支模型

• master：稳定主分支，只接受经评审后的合并，不直接提交开发代码。
• develop：开发集成分支，日常开发默认从它拉分支、合回。
• 功能分支：feature/<简短描述>，从 develop 拉出，完成后合回 develop。
• 修复分支：bugfix/<简短描述>，从 develop 拉出。
• 紧急修复：hotfix/<简短描述>，从 master 拉出，修复后合回 master 与 develop。
• 发布分支：release/<版本号>，从 develop 拉出，测试通过后合回 master 并打标签 v<版本号>。

2、首次克隆与开分支

git clone <仓库地址>
git checkout -b feature/my-feature develop   # 从 develop 拉功能分支

3、日常提交

git add <文件>          # 只添加本次改动相关文件，不要 git add -A 一把梭
git commit -m "feat: 新增xxx"   # 提交信息格式：type: 描述
git pull --rebase origin develop              # 合入前先同步远端
git push -u origin feature/my-feature

提交信息前缀：feat（功能）、fix（修复）、docs（文档）、refactor（重构）、test（测试）、chore（杂项）。

4、合并与评审

• 通过合并请求（MR/PR）把功能分支合入 develop，由他人评审后合并。
• 不要把自己的个人分支长期保留在共享远端；合并后删除。
• 合入前确保已通过对应模块的验证命令（见 AGENTS.md「验证」）。

5、与远端同步

git fetch origin
git pull --rebase origin develop