github-repo-management

GitHub 仓库管理

规则

• 机密信息：不要在输出、命令或文件内容中回显、记录或包含任何令牌或机密信息。GitHub MCP 会处理身份验证。
• 破坏性操作：执行 git push --force、git branch -D、删除仓库或覆盖远程历史记录前，请先征求确认。
• 默认分支：优先使用 main；仅当仓库已使用 master 时才使用 master。
• 提交：使用 Conventional Commits（例如 feat:、fix:、docs:）。

功能

• 在本地运行 git 命令（init、add、commit、push、branch、checkout 等）。
• 仅通过 GitHub MCP 操作 GitHub：创建仓库、获取仓库信息、列出/创建/合并 PR、管理分支。不要直接使用 REST API 或 GITHUB_TOKEN。

---

创建仓库

当用户要求“创建仓库”或“创建 GitHub 仓库”时：

1. 在 GitHub 上创建（仅使用 GitHub MCP）：

   • 使用 GitHub MCP create_repository（或等效工具），并设置 name、可选的 description 和 private（默认值根据用户意图确定）。

2. 在本地设置 origin（如果当前已处于 git 仓库中）：

   git remote add origin https://github.com/<owner>/<repo>.git
   

   如果 origin 已存在，且需要将其指向新仓库，请先征求确认。

3. 如果尚无本地仓库：

   git init
   git remote add origin https://github.com/<owner>/<repo>.git
   

4. 首次推送（至少完成一次提交后）：

   git push -u origin main
   

   使用 main，除非 GitHub 仓库创建时设置了其他默认分支。

---

推送代码

当用户要求“推送代码”或“推送到 GitHub”时：

1. 确保 git 仓库存在：运行 git status。如果当前目录不是仓库，询问是否要运行 git init 并设置远程仓库。
2. 检查远程仓库：运行 git remote -v。如果没有 origin，询问仓库 URL，或先创建仓库。
3. 规范提交：
   • 运行 git status 查看更改。
   • 暂存：运行 git add <paths>；如果用户希望包含所有更改，则运行 git add -A。
   • 使用符合规范的提交消息：git commit -m "type(scope): description"。
   • 如果存在未提交的更改，且用户说了“推送”，请先询问是否提交；未经询问不得强制推送。
4. 推送：运行 git push origin <branch>。默认分支为 main。如果尚未设置上游分支：运行 git push -u origin main。

---

获取仓库信息

当用户要求“获取仓库信息”“仓库详情”或“显示仓库”时：

1. 确定仓库：从 git remote get-url origin（owner/repo）或用户提供的 owner/name 中获取。
2. 通过 GitHub MCP 获取：使用 MCP 工具获取仓库详情（例如获取仓库、列出分支、列出 PR）。总结：名称、描述、默认分支、可见性，以及可用时的星标数/复刻数和克隆 URL。

---

分支

• 创建分支：运行 git checkout -b <branch-name>，然后推送：git push -u origin <branch-name>。
• 切换分支：运行 git checkout <branch> 或 git switch <branch>。
• 删除分支：本地运行 git branch -d <branch>；远程分支仅在用户确认后删除：git push origin --delete <branch>。

---

拉取请求

• 创建 PR：使用 GitHub MCP 创建拉取请求（head、base，默认值为 main、title、body）。
• 列出 PR：使用 GitHub MCP 列出 PR；按编号、标题、状态和作者进行总结。
• 合并：使用 GitHub MCP 合并；合并前请先征求用户确认。

---

Conventional Commits 提交消息

使用以下格式：type(scope): short description。

类型	用途
feat	新功能
fix	修复错误
docs	仅修改文档
style	格式调整，不更改代码
refactor	更改代码，不涉及功能或错误修复
test	添加或更新测试
chore	构建、工具、依赖

示例：

• feat(auth): add login endpoint
• fix(api): correct date parsing
• docs: update README setup steps

---

总结清单

• GitHub 操作：仅使用 GitHub MCP（不使用 REST API，命令中不使用 GITHUB_TOKEN）。
• 强制推送、删除分支或删除仓库前，请先确认。
• 默认分支：main。
• 所有提交：使用 Conventional Commits 风格。