arthur0824hao/git

Git — 版本控制操作

跟 github skill 分工：git = local 版本控制，github = remote platform (issues/PRs/actions)。 優先使用 .bh/scripts/bh-git.sh wrapper；raw git 只在 wrapper 缺功能時用。

BH Commit 規範

# Format
git commit -m "$(cat <<'EOF'
feat(bh): <description>

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
EOF
)"

# Prefixes
feat(bh):   — BH 新功能
feat(ep):   — EP 新功能
fix(bh):    — BH bug fix
chore:      — 維護/清理
docs:       — 文件

• 一次 commit 一個 logical change
• 不 amend 已 push 的 commit
• Co-Authored-By 必附

Branch 策略

• main-only（目前）— 不開 feature branch
• Worktree：大型 refactor / 實驗性改動用 git worktree add
• 禁止 force push main

安全操作

| 禁止 | 替代 | |---|---| | git reset --hard | git stash 或 git checkout -- <file> | | git push --force | git push（如需 force 問 Arthur） | | git clean -f | 手動 rm 確認的檔案 | | commit 大檔案 | .gitignore 先設 | | commit esun_data/ | 永遠不 commit 敏感資料 |

常用操作

# 狀態
git status                    # 看改了什麼
git diff                      # unstaged changes
git diff --staged             # staged changes
git log --oneline -10         # 近 10 commit

# Stash
git stash                     # 暫存
git stash pop                 # 恢復
git stash list                # 列出

# Cherry-pick
git cherry-pick <commit>      # 挑特定 commit

# Worktree
git worktree add ../worktree-name branch-name
git worktree remove ../worktree-name

# Blame
git blame <file>              # 誰改的哪一行

# Rebase (注意: -i 在 CLI 不可用)
# 用 git rebase <base> 不加 -i

BH Git Wrapper

bash .bh/scripts/bh-git.sh    # 有 push guard, audit wrapper
# force push 會被 force_push_requires_arthur 擋下

Cross-link

• 需要 PR/issue/workflow → 用 github skill
• 需要 commit/diff/stash/push → 留在本 skill