| name | git-push-to-github |
| description | Safely commits intended local changes and pushes them to a GitHub branch. 当用户明确要求提交并推送代码到 GitHub 时调用。 |
Git Push to GitHub
Use this skill when
- 用户明确要求提交并推送本地代码到 GitHub。
- 用户明确指定要更新的远程分支。
- 用户要求把已经完成的提交同步到 GitHub。
不要用于只读状态查询、回滚、强制推送或未经授权的分支合并。
Inputs
repo_path: 仓库路径，默认当前目录。remote: 远程名称，默认 origin。branch: 目标分支，默认当前分支；不要擅自假定为 main。commit_message: 可选提交说明；未提供时根据本次明确范围内的变更生成简短中文说明。paths: 本次允许暂存的文件路径；应从任务范围和 git status 中明确得出。
Outputs
success: 是否完成。branch: 实际推送的目标分支。commit_hash: 推送后的提交哈希。commit_message: 提交说明。push_result: 推送与远程校验结果。error_message: 失败原因及安全的下一步建议。
Safe workflow
- 确认仓库与范围：
- 运行
git status --short --branch、git remote -v、git branch -vv。
- 确认目标远程和目标分支与用户要求一致。
- 工作区包含无关或来源不明的改动时，保留它们且不要暂存；无法隔离时停止并说明。
- 获取远程状态：
- 运行
git fetch <remote> --prune。
- 比较本地目标分支与
<remote>/<branch>，禁止在不了解远程新提交时直接推送。
- 暂存与审查：
- 只运行
git add -- <明确文件路径...>，禁止无条件使用 git add .、git add -A。
- 用
git diff --cached --check 和 git diff --cached --stat 检查暂存内容。
- 检查敏感文件、构建缓存和临时文件是否被意外纳入。
- 验证：
- 运行与改动风险相匹配的测试、类型检查、Lint 或构建。
- 验证失败时不要提交或推送；报告失败并保留现场。
- 提交：
- 仅在存在已暂存变更时执行
git commit -m "<说明>"。
- 若改动已经提交，复用现有提交，不创建空提交。
- 同步目标分支：
- 当前分支就是目标分支时，先以
git pull --ff-only <remote> <branch> 更新。
- 当前分支不是目标分支且用户明确要求直接更新目标分支时，切换到目标分支，以
--ff-only 同步远程，再 cherry-pick 本次明确提交。
- 出现冲突时停止，不自动丢弃、覆盖或重写任何一方的改动。
- 推送：
- 使用
git push <remote> HEAD:<branch>。
- 禁止
--force、--force-with-lease，除非用户在了解风险后单独明确授权。
- 远程校验：
- 再次
git fetch <remote>。
- 确认
git rev-parse HEAD 与 git rev-parse <remote>/<branch> 一致。
- 输出分支、提交哈希、提交说明和验证结果。
Failure handling
- 非 Git 仓库或远程缺失：停止并报告；未经确认不要初始化仓库或新增远程。
- 身份缺失：报告缺失项；不要自行设置
user.name 或 user.email。
- 远程领先或非快进：先 fetch 并展示分叉；只使用 fast-forward、rebase 或明确的 cherry-pick 方案，冲突时停止。
- 认证或权限失败：报告 GitHub 返回的原始错误，建议用户检查凭据和仓库权限。
- 网络、HTTP/2、SSL、SSH 失败：先执行只读诊断；不要自动修改远程 URL、
/etc/hosts、SSH 配置或全局 Git 配置。
- 推送后连接中断：先 fetch 并比较远程提交，确认是否其实已经成功，避免重复操作。
Security and repository hygiene
- 不读取或输出令牌、私钥、密码和凭据内容。
- 不关闭 SSL 校验，不修改全局 Git 配置。
- 不使用破坏性命令，例如
git reset --hard、git clean -fd 或强制推送。
- 不覆盖用户已有改动；所有暂存文件都必须属于当前任务范围。
- 修改远程地址、本地身份、代理、SSH 或系统网络配置前必须取得用户确认。
