4.2 KiB
4.2 KiB
# Git 仓库初始化配置任务
## 任务目标
你现在作为项目 Git 管理负责人，负责完成当前项目的 Git 初始化、远程仓库配置、开发者信息配置、SSH/GPG 签名配置、首次提交以及推送。
要求：
- 所有 Git 操作规范化
- 提交信息必须使用中文
- 提交作者信息统一
- 配置安全认证
- 完成首次正式提交
---
# 一、Git 初始化
## 初始化仓库
执行：
```bash
git init
检查状态：
git status
二、配置 Git 用户信息
开发者信息：
姓名：
旅行呀~
邮箱：
travelxiao@qq.com
配置：
git config user.name "旅行呀~"
git config user.email "travelxiao@qq.com"
检查：
git config --list
要求：
提交作者显示：
旅行呀~ <travelxiao@qq.com>
三、添加远程仓库
远程仓库地址（Gitea 示例，换成你的主机）：
git@git.example.com:owner/repo.git
https://git.example.com:3000/owner/repo.git
ssh://git@git.example.com:2222/owner/repo.git
添加：
git remote add origin <Gitea仓库URL>
检查：
git remote -v
要求：
origin fetch
origin push
四、配置 Git Token
使用 Gitea 访问令牌 进行 HTTPS 远程认证。
要求：
- Token 仅保存本地（DPAPI 加密，见 git-init skill）
- 不允许写入代码
- 不允许提交到仓库
在 Gitea：设置 → 应用 → 生成新令牌。HTTPS 用户名为 Gitea 登录名，密码为令牌。
配置凭据保存：
git config --global credential.helper manager
首次由 skill 的 store-token.ps1 / inject-credential.ps1 完成，不要在对话中粘贴令牌。
五、生成 SSH 密钥
生成 ED25519 SSH Key：
ssh-keygen -t ed25519 -C "travelxiao@qq.com"
启动（Windows 用 OpenSSH 服务，不要用 eval ssh-agent）：
# Windows PowerShell: Start-Service ssh-agent
eval "$(ssh-agent -s)"
添加：
ssh-add ~/.ssh/id_ed25519
查看公钥：
cat ~/.ssh/id_ed25519.pub
将公钥添加到 Gitea → 设置 → SSH / GPG 密钥。
测试（把主机换成你的 Gitea；自定义端口用 -p）：
ssh -T git@git.example.com
ssh -p 2222 -T git@git.example.com
或使用 skill：test-ssh.ps1 -RemoteUrl <SSH仓库URL>。
六、生成 GPG 签名密钥
生成：
gpg --full-generate-key
信息：
姓名：
旅行呀~
邮箱：
travelxiao@qq.com
查看 Key：
gpg --list-secret-keys --keyid-format LONG
配置 Git 签名：
git config user.signingkey KEY_ID
开启提交签名：
git config commit.gpgsign true
将 GPG 公钥添加到 Gitea → 设置 → SSH / GPG 密钥（导出：gpg --armor --export KEY_ID）。
七、Git 提交规范
所有提交信息必须使用中文。
格式：
类型: 描述
示例：
初始化: 完成项目Git配置
新增: 添加用户模块
修复: 修复登录问题
优化: 优化代码结构
文档: 更新README
禁止：
update
fix
test
修改一下
八、完善 README
完善项目根目录：
README.md
要求：
包含：
- 项目简介
- 基础使用说明
- 项目结构
- 开发说明
九、第一次提交
添加文件：
git add .
提交：
git commit -S -m "初始化: 完成项目初始化配置并完善README文档"
十、推送远程仓库
设置主分支：
git branch -M main
推送：
git push -u origin main
十一、最终检查
执行：
git status
git remote -v
git log --show-signature -1
确认：
- Git 初始化成功
- 用户信息正确
- 远程仓库连接成功
- SSH 配置完成
- GPG 签名成功
- 首次提交完成
- 代码成功推送
十二、后续提交要求
以后所有提交：
作者：
旅行呀~ <travelxiao@qq.com>
提交信息：
必须中文。
每次提交必须包含清晰描述：
例如：
新增: 添加支付接口
修复: 修复数据异常问题
优化: 优化接口性能
目标：
建立规范、安全、可维护的 Git 仓库环境。