git-remote-push

name	git-remote-push
description	處理將本地更改推送到遠端倉庫（如 GitHub）。自動偵測遠端預設分支，同步分支命名，並處理權限問題。

Git 遠端推送工作流 (Git Remote Push Workflow)

當使用者要求將程式碼「推送」、「上傳」至 GitHub 或任何遠端倉庫時，請遵循此工作流。

1. 環境偵測 (Environment Discovery)

在執行推送前，必須先確認遠端狀態：

• 執行指令：git remote -v 獲取遠端 URL。
• 執行指令：git ls-remote --symref origin HEAD 識別遠端的預設分支名稱（通常為 main 或 master）。

2. 分支同步策略 (Branch Sync Strategy)

不要假設本機分支名稱與遠端一致。

• 檢查目前分支：git branch --show-current。
• 執行推送：
  • 若本機分支為 master 且遠端預設為 main，執行 git push origin master:main。
  • 若遠端已有內容，且需要覆蓋或同步，應根據情況加上 --force 並告知使用者原因。
  • 原則：直接使用遠端最新的分支資訊進行對應推送，不需詢問使用者是否重新命名本機分支。

3. 權限與安全性處理 (Permissions & Security)

• 403 Forbidden 錯誤：若推送失敗顯示權限不足，主動建議使用者將帳號嵌入 URL：
  • git remote set-url origin https://<username>@github.com/<username>/<repo>.git
• 憑證檢查：提醒使用者 Windows 認證管理員 (Credential Manager) 可能存有舊憑證。

4. 驗證 (Verification)

推送完成後，執行 git ls-remote origin 確認遠端 HEAD 是否已更新，或提供遠端倉庫連結供使用者確認。

5. 注意事項

• 禁止自動 Push：始終向使用者說明即將執行的 Git 指令及其影響，取得同意後再執行。
• Gitignore 檢查：在推送前確認 .gitignore 已包含必要排除項（如 node_modules, .env）。