Git 不是程序员的专利，
是团队协作的基础设施。

仓库是 Git 管理的项目根目录。它包含项目的所有文件、文件夹，以及完整的修改历史。每个项目对应一个仓库，通常托管在 GitHub 上。团队所有人都从同一个仓库获取最新内容，也向同一个仓库提交自己的修改。

# 克隆一个远程仓库到本地（只需要做一次）
git clone https://github.com/company/project-name.git

# 进入项目目录
cd project-name

Commit 是 Git 中最基本的操作。每次 commit 会记录你修改了哪些文件、修改了什么内容、是谁在什么时间做的修改，以及一段描述信息。多个 commit 串起来就形成了项目的完整历史时间线。

# 查看当前有哪些文件被修改了
git status

# 把修改的文件加入「暂存区」（准备存档）
git add INTENT.md

# 提交（存档），附上一句说明
git commit -m "更新了用户画像描述"

分支让你在不影响主线（main 分支）的情况下，独立进行修改。每个人在自己的分支上工作，完成后再合并回主线。这样即使你的修改出了问题，也不会影响其他人。分支是团队并行协作的基础。

# 创建一个新分支并切换到它
git checkout -b feature/update-intent

# 查看当前在哪个分支
git branch

# 切换回主分支
git checkout main

当你在分支上完成修改后，需要把修改合并（merge）回主分支。大多数情况下 Git 可以自动完成合并。但如果两个人修改了同一个文件的同一处内容，就会产生「冲突」（conflict），需要人工选择保留哪个版本。

# 先切换到主分支
git checkout main

# 把你的分支合并进来
git merge feature/update-intent

# 如果有冲突，Git 会提示你手动解决

Merge Request（简称 MR）是 GitLab 上的协作机制，GitHub 上叫 Pull Request（PR），本质完全相同。当你在分支上完成修改后，不是直接合并，而是创建一个 MR，邀请团队成员审阅。MR 页面会清晰展示你改了什么，团队可以逐行评论。这是我们 PRD → PR 模式的核心——所有变更都通过 MR 来讨论和确认。

# 把你的分支推送到远程仓库
git push origin feature/update-intent

# 然后在 GitLab 网页上点击「New merge request」创建 MR
# GitLab 会在你 push 后自动提示创建 MR 的链接