Git 與 PR 工作流程
- 同步：
git fetch origin main && git checkout main && git reset --hard FETCH_HEAD（克隆可能是淺層的；origin/main可能解析失敗）。 - 分支：對於 sprint 票證，使用
git checkout -b S<n>/<area>/<slug>（請參考docs/sprints/）；否則使用fix/、docs/或chore/加上一個 slug。 - 以小提交方式工作。每次提交前，請查閱
AGENTS.md中的命令。 - 在同一個 PR 中更新
docs/HANDOFF.md（技能handoff）。 - 提交訊息：
type(scope): 祈使句摘要
用一兩句話說明為什麼做此更改。
Co-Authored-By: Abdullah Farag <[email protected]>
Co-Authored-By: <你的模型名稱> <[email protected]>
- 推送：
git push -u origin <branch>。 - 使用 REST API（雲端工作階段中 GraphQL 被封鎖）開啟 PR：
gh api repos/al0olo/agents-village/pulls \
-f title="type: 摘要" -f head=<branch> -f base=main -F body=@/tmp/pr.md --jq '.html_url'
內容：變更什麼、原因、你如何檢查，以及審核者需要決定的任何事項。 8. 如果 CI 失敗，請閱讀日誌，在同一分支上修復，然後推送。不要合併紅色的 CI。 9. 合併順序：如果 PR 互相依賴，請在 body 中說明，並按順序合併。
永遠不要直接提交到 main，不要對共享分支進行強制推送，永遠不要跳過鉤子。