用途:在开发过程中执行 Git 与 GitHub 操作,包括提交、推送、拉取、分支、拉取请求、issue、历史审查、冲突解决与工作树管理,并统一采用 Conventional Commits 格式。
主要能力:提交格式为 <type>(<可选 scope>): <简要描述> 加可选正文。类型含 feat、fix、docs、refactor、test、chore、perf;scope 使用包名如 engine、landing、plant、aspen、heartwood、prism、foliage、lumen、billing。日常流程为 git status、git diff --stat、git add .、git commit、git push、gh pr create。读取操作用 git status、git diff、git diff --staged、git diff main...HEAD、git log --oneline -20、git log --stat -5、git blame、git show。
使用方式:直接使用原生 git 和 gh;仅 issue 驱动的工作树用 gw:gw git worktree create 1234 --write 创建,gw git worktree finish --write 完成(提交、推送、合并进 main、移除工作树),可加 -m 自定义信息或用 --no-merge 跳过合并;git worktree list 查看。GitHub 操作用 gw gh issue list 浏览,gh issue create/close,gh pr create/list/view/merge,gh run list/view。分支命名如 feature/feature-name、fix/bug-description、refactor/what-changed。冲突时用 git status 定位,手动解决后 git add 与 git commit,或用 git checkout --ours/--theirs。撤销用 git restore、git restore --staged、git reset --soft HEAD~1、git reset HEAD~1、git revert。
限制与建议:不要强推到 main/master,不要提交密钥、.env 或 API 密钥,不把无关改动放进一个提交,不用含糊信息;每提交一个逻辑变更,主题行 50 字符内,用祈使语气,footer 引用 issue(Fixes #123)。