team-guide/AI工具说明.md

让 AI 编程工具（Cursor 等）使用我们的仓库

1. 准备

1. 按 使用指南 创建一个访问令牌（repository 读写）。
2. 复制仓库的 HTTPS 地址：

https://git.yjsnpitext1145141.top/用户名/仓库名.git

3. 在 Cursor 里：「Clone Repository」粘贴地址；或打开终端运行 git clone 地址。要密码时：用户名填你的用户名，密码粘贴令牌。

2. 复制给 AI 的提示词

开始工作前，把下面这段整段发给 AI（把尖括号里的换成你的）：

我们团队的代码仓库在自建 Gitea 上：
- 网址：https://git.yjsnpitext1145141.top/
- 本仓库：https://git.yjsnpitext1145141.top/<用户名>/<仓库名>.git
- 用 HTTPS 推送，SSH 端口是 2222（一般不用）

请遵守：
1. 不要直接改 main 分支。每个任务先新建分支，例如 feature/登录页 或 fix/按钮错位（分支名用英文：feature/login-page）。
2. 提交信息用简短清楚的中文，说明做了什么，例如「新增登录页面」「修复首页按钮错位」。小步多次提交。
3. 绝对不要提交密码、API Key、令牌、.env 文件、私钥。先确认 .gitignore 里有 .env、node_modules 等，没有就加上。
4. 不要提交大文件（视频、安装包、数据集、超过 10MB 的文件）。
5. 做完后 push 分支，然后告诉我如何在 Gitea 网页上创建合并请求（Pull Request）到 main，并帮我写好 PR 标题和中文说明。
6. 如果 push 时要求输入用户名密码，停下来提醒我：用户名填我的 Gitea 用户名，密码填我的访问令牌（不是登录密码）。不要把令牌写进代码或任何文件。
7. 每一步都用通俗的话告诉我你在做什么。

3. 推送时要密码怎么办

• 用户名：你的 Gitea 用户名
• 密码：访问令牌
• 令牌只粘贴到弹出的密码框里，不要发到聊天群、不要写进代码。
• 令牌泄露了：去「设置 → 应用」删掉它，再生成一个新的。

4. 开 PR（合并请求）

1. 打开仓库网页，会提示你刚推送的分支，点「创建合并请求」。
2. 目标分支选 main，写标题和说明（可以让 AI 写）。
3. 提交后等「审查」机器人和老师看，按意见修改后再合并。