github-collablisted
Install: claude install-skill radbadboywimps-dev/github-collab-skill
# GitHub 协作流程
## 触发边界
**只在用户明确要做 git/GitHub 操作时介入**(提交、推送、建仓库、分支、PR、发版、回退、同步等)。
纯编码、调试、重构、写测试、读代码、技术讨论时**不触发、不检查、不打扰**。
## 启动检查(执行 git/GitHub 操作前)
0. **环境准备**(每个会话首次执行 git 操作时):
- 检测 git 是否可用:先试 `git --version`,不可用则按平台查找常见安装路径(详见 [references/platform-commands.md](references/platform-commands.md) 的 git 路径表)
- 找到便携版 git 时,将其目录加入当前会话 PATH(不修改系统环境变量)
- 找不到 git → 引导安装(Windows: winget 或便携版;macOS: `brew install git`;Linux: `apt/yum install git`)
- Windows PowerShell 下设置 `$env:GIT_REDIRECT_STDERR = '2>&1'`,消除 git 进度信息导致的红色错误显示
- 检测结果在当前会话缓存,不重复检测
1. 确定工作目录:用户指定的项目路径,或当前对话中正在操作的目录
2. 检查是否为 git 仓库:
- 不是 → 询问用户是否初始化(走"新项目初始化"流程)
- 是 → 执行 `git status` 和 `git branch --show-current` 确认状态
3. 确定流程模式(见"流程模式"章节):
- 读取 AGENTS.md 中的 `## GitHub 协作设置`(如有)
- 结合用户本次语气判断走简单还是完整流程
4. 检查项目根目录是否有 AGENTS.md:
- 有 → 读取并遵循其中的项目约定
- 没有且走完整流程 → 扫描项目结构,按 [references/agents-template.md](references/agents-template.md) 生成一份,展示给用户确认后写入
- 没有且走简单流程 → 不主动生成,等用户要求或项目变复杂时再说
5. 如果是已有仓库,开始工作前先 `git pull` 拉取最新代码(简单流程下静默执行,失败不阻塞)。如果本地与远程因 MCP 上传而分叉,按"本地与远程历史分叉"章节处理
## 工具分工
| 操作类型 | 使用工具 |
|----------|----------|
| 本地文件暂存、提交、查看差异、日志、分支切换、stash | 本地 git 命令 |
| 推送、拉取(push/pull/fetch) | 本地 git 命令 |
| 创建仓库、Fork | GitHub MCP(create_repository / fork_repository��� |
| Pull Request 创建、审查、合并 | GitHub MCP(create_pull_request / pull_request_review_write / merge_pull_request) |
| Issue 创建、评论、标签 | GitHub MCP(issue_write / add_issue_comment) |
| Release 发布 | GitHub MCP(get_latest_release / list_