| name | push |
| source | ../../../../skills/push/SKILL.md |
| source_version | 2.0.0 |
| translation_version | 2.0.0 |
| last_synced | "2026-06-02T00:00:00.000Z" |
| source_hash | b7812535483c |
| scope | universal |
| description | [UDS] AI 輔助 git push 安全層：品質閘門 + 協作護欄。
Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保護分支, 品質閘門.
|
| allowed-tools | Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*) |
| argument-hint | [--force] [--target <branch>] [--skip-gates] [--no-pr] |
推送助手
語言: English | 繁體中文
版本：2.0.0
建立日期：2026-04-23
適用範圍：Claude Code Skills
git push 的 AI 輔助安全層。偵測保護分支、強制 force-push 護欄、執行 pre-push 品質閘門、輸出結構化推送收據，並整合 PR 自動化。
核心標準
本 Skill 實作 .standards/push-standards.ai.yaml。
執行工作流程
呼叫 /push 後，Claude 原生依序執行以下步驟：
Step 1：偵測保護分支
執行 git rev-parse --abbrev-ref HEAD 取得目前分支。
比對 protected_branches 清單（預設：main、master、release/、hotfix/）。
若為保護分支：顯示警告 + 待推送的 commit 列表，需使用者明確確認才能繼續。
Step 2：偵測 Force Push
若偵測到 --force 或 --force-with-lease：
執行 git log origin/<branch>..HEAD --oneline 找出將被覆蓋的 commits。
顯示數量與作者列表。需要使用者輸入 yes, force push 才能繼續。
Step 3：執行 Pre-Push 品質閘門
依序使用 Bash tool 執行每個已設定的閘門：
lint：偵測並執行專案 lint 指令test：偵測並執行專案測試指令type-check（選用）：TypeScript 型別檢查ac-coverage（選用）：驗收條件覆蓋率security-scan（選用）：安全漏洞掃描
若任何必要閘門失敗：中止並顯示錯誤訊息。
Step 4：執行推送
執行 git push <remote> <branch> [--force]。
若推送失敗：顯示 git 錯誤並建議修正方式。
Step 5：發出推送收據
將結構化收據輸出到 console（可選擇寫入 ~/.uds/push-history.jsonl）：
{
"branch": "<branch>",
"commit_sha": "<sha>",
"gates_passed": ["lint", "test"],
