先说人话:Git 像本机的“修改记录本”,GitHub 和 Gitee 像放在网上的“项目保险箱”。
Agent 会用 Git,不等于你的项目已经保存好,也不等于已经上传到网上。
三个名字,分别是干什么的
| 名称 | 它是什么 | 解决什么问题 |
|---|---|---|
| Git | 本机上的版本记录工具 | 记录每次修改、比较差异、创建分支和恢复版本 |
| GitHub | 托管 Git 仓库与协作的平台 | 远程备份、PR 审查、Issue、权限、CI、发布与团队协作 |
| Gitee(码云) | 国内 Git 仓库托管与协作平台 | 国内访问、远程备份、团队协作、代码审查与流水线 |
| Agent 的 Git 能力 | Agent 运行 Git 命令的能力 | 帮你执行操作,但安全边界仍由仓库规则决定 |
为什么 AI 改项目时,更要保存版本
- Agent 一次可能修改很多文件,必须能看到它到底改了什么;
- 结果不对时,需要恢复到明确的旧版本;
- 多个 Agent 或多人并行时,需要分支和合并;
- 上线前需要 PR 审查和自动检查;
- 本机坏了或项目换电脑时,需要远程主源;
- 每一次“有效方法”都能和对应代码、配置、Skill 一起保存。
新人先照着这七步做
- Agent 开工前确认当前分支和工作区状态;
- 一个任务使用一个分支;
- 修改后先看差异,不直接全部接受;
- 运行检查与构建;
- 写清楚这次改了什么,再提交;
- 推到 GitHub 或 Gitee,通过代码审查和自动检查再合并;
- 正式版本使用 Tag 或 Release 标记。
连接远程仓库应该限制什么
| 风险动作 | 建议规则 |
|---|---|
| 读取公开仓库 | 可以自动执行 |
| 修改分支和提交 | 允许,但必须展示差异 |
| 推送远程 | 限定仓库与分支 |
| 合并 PR | 检查通过后由人确认 |
| 删除分支/仓库/Release | 必须人工确认 |
| 读取密钥和生产环境 | 默认禁止,按任务最小授权 |
GitHub 和 Gitee 怎么选
| 更看重什么 | 可以优先考虑 |
|---|---|
| 国际开源生态、Actions、海外服务集成 | GitHub |
| 国内访问、国内团队协作、Gitee 生态 | Gitee |
| 只是个人短期试验,不需要远程备份 | 暂时只用本地 Git |
平台不是重点。真正重要的是:只保留一个明确的远程主源,不要让两个平台各自出现互相冲突的“最新版”。
什么时候只用本地 Git 就够了
一次性个人试验、没有协作也不需要部署时,本地 Git 已经能保存版本。但只要项目要长期维护、换设备、多人协作或自动发布,GitHub 这类远程主源就非常重要。
官方核验入口
复制给 AI · Git/GitHub/Gitee
把整段话发给能操作本机项目的 AI,它会带着你执行。
登录、创建仓库、首次推送和其他高风险动作仍由你确认;普通聊天 AI 无法操作本机。复制后先替换方括号内容。 密码、Token、私钥和客户隐私不要贴进对话;登录、付款、发布和破坏性操作仍需由你确认。
GitHub01
把本机现有项目安全上传到 GitHub
保留现有文件与历史,默认创建私有仓库,并把 GitHub 设为唯一远程主源。
先查看内容
你现在是我的版本管理执行助手。请直接检查并帮助我把“当前打开的本机项目”安全连接到 GitHub,不要只给教程。 先检查准确路径、Git 状态、当前分支、远程地址和未提交修改;再检查官方登录是否已完成。不要让我把密码、Token 或密钥发到聊天里。上传前检查 .env、密钥、证书、数据库、大型缓存、构建产物和隐私文件,先完善 .gitignore 并说明排除项。 如果已有 Git 历史必须保留;如果没有远程仓库,只向我确认 GitHub 用户名或组织、仓库名、是否公开,默认私有。在创建仓库、添加远程地址或首次推送前,用中文汇报将执行的准确动作并等我确认。禁止删除现有文件、强制推送、覆盖远程历史、关闭检查或打印凭据。 完成后核验仓库网址、当前分支、最新提交、推送状态和敏感文件排除结果,并告诉我以后安全提交更新应该说哪一句话。
Gitee02
把本机现有项目安全上传到 Gitee
适合国内代码托管,把 Gitee 作为项目唯一远程主源。
先查看内容
你现在是我的版本管理执行助手。请直接检查并帮助我把“当前打开的本机项目”安全连接到 Gitee(码云),不要只给教程。 先检查准确路径、Git 状态、当前分支、远程地址、未提交修改和可用的官方登录/SSH/HTTPS 凭据。不要让我把密码、Token 或私钥发到聊天里。上传前检查 .env、密钥、证书、数据库、大型素材、缓存、构建产物和隐私文件,先完善 .gitignore 并说明排除项。 已有 Git 历史必须保留。如果还没有 Gitee 仓库:具备网页操作且我已登录时,先征得同意再创建私有仓库;不能操作网页时,只让我完成“新建空仓库”这一个必要步骤。在添加远程地址或首次推送前汇报准确动作并等我确认。禁止删除文件、强制推送、覆盖历史或显示凭据。 完成后核验仓库网址、分支、提交、推送状态和敏感文件排除结果。
接管已有仓库03
把已有 GitHub/Gitee 仓库安全拉到本机
遇到非空目录、登录或冲突时停下来,不会直接覆盖。
先查看内容
请作为我的代码仓库接管助手,帮助我把一个已经存在的 GitHub 或 Gitee 仓库安全连接到本机。 先向我索取仓库网址和准备保存到的本机目录,再检查登录状态、目标目录、默认分支、远程分支和启动说明。目录非空时不得覆盖;不得删除本机文件、强制拉取、重写历史,也不要让我发送密码、Token 或私钥。 拉取后先保持项目不变,检查 Git 状态、依赖说明、环境变量示例和启动方式。未经确认,不要安装来历不明的脚本、修改代码或推送内容。完成后用中文告诉我本机路径、远程地址、当前分支、最新提交、项目是否完整和最安全的启动方式。
日常提交04
每次修改后安全保存并同步版本
检查差异和敏感文件,只提交本次任务相关内容。
先查看内容
请把当前项目这次已经完成的修改安全保存到版本库并同步到远程仓库,不要修改无关内容。 先检查并汇报当前分支、未提交文件、主要差异、是否混入密钥或隐私文件,以及应该运行哪些测试。发现无关改动时保留它们,不要擅自覆盖、丢弃或一起提交。检查失败时说明原因,不要提交明知有问题的版本。 检查通过后,拟定清楚的中文提交说明,列出准备提交的准确文件,并在真正提交和推送前让我确认一次。禁止强制推送、跳过检查、删除历史或自动合并主分支。完成后告诉我提交编号、说明、仓库与分支、检查结果和剩余未提交内容。
只读体检05
连接远程仓库前只检查,不上传
暂时不创建仓库、不提交、不推送,也不修改文件。
先查看内容
请对当前打开的项目做一次“连接 GitHub 或 Gitee 前的只读体检”。不要创建远程仓库、提交、推送、修改或删除任何文件。 请检查:准确路径、文件规模、是否已使用 Git、当前分支和历史、现有远程地址、未提交修改、.gitignore 是否完整,以及是否存在 .env、密钥、Token、证书、数据库、隐私文件、大型素材、缓存或构建产物。 最后用小白能看懂的中文告诉我:哪些可以上传、哪些必须排除、是否适合连接远程仓库、还缺哪一步、可能有什么风险。不要显示任何敏感文件的具体内容。