#版本管理与交付

#区分操作阶段

文件修改、Git 提交、远程推送和创建合并请求属于不同步骤。完成代码编辑后，应先查看差异与验证结果，再决定是否提交及发布。

可以先使用只读命令查看当前状态：

git status
git diff

若当前目录不是 Git 仓库，应先明确是否需要初始化版本管理。已有未提交修改时，应区分本次任务与此前人工修改，避免在整理提交时一并覆盖或删除。

#准备提交说明

请为本次{阅读状态筛选}变更准备提交说明与合并请求草稿。

先核对本次涉及的文件和测试结果。
说明内容包括：
1. 原有问题或新增需求；
2. 本次修改及形成的行为；
3. 实际执行的测试；
4. 未完成的检查及需要审阅者关注的事项。

只准备文本，不执行提交、推送、合并或部署。
如发现混入与本次任务无关的修改，请单独列出。

正式执行时，再明确仓库、分支及操作范围。例如，可以授权创建本地提交，但暂不推送；也可以在检查完成后授权推送指定分支并创建合并请求。权限安排应与实际协作流程一致。

#隔离并行修改

需要同时开展多个修改时，可使用 Git worktree，为不同任务提供独立工作目录。Claude Code 支持在已有 Git 仓库中通过以下命令启动工作树会话：

claude --worktree {reading-filter}

示例中的 reading-filter 是自定义任务名称。仓库通常应已有提交；新工作树还可能需要准备依赖和本地配置。工作树共享 Git 历史，但保有各自的工作文件与分支，不会自动合并，也不能代替备份。清理前应确认其中的修改和提交已经妥善保留。