Git 与 PR 工作流
- 同步：
git fetch origin main && git checkout main && git reset --hard FETCH_HEAD（克隆可能是浅层的；origin/main可能无法解析）。 - 分支：对于冲刺工单（参见
docs/sprints/），执行git checkout -b S<n>/<area>/<slug>；否则使用fix/、docs/或chore/加一个 slug。 - 小幅度提交。每次提交前执行门控检查：见
AGENTS.md命令。 - 在同一 PR 中更新
docs/HANDOFF.md（技能handoff）。 - 提交信息格式：
类型(范围): 祈使句摘要
解释这次变更的原因，一两句话。
Co-Authored-By: Abdullah Farag <[email protected]>
Co-Authored-By: <您的模型名称> <[email protected]>
- 推送：
git push -u origin <分支>。 - 使用 REST API 打开 PR（云会话中 GraphQL 被阻止）：
gh api repos/al0olo/agents-village/pulls \
-f title="类型: 摘要" -f head=<分支> -f base=main -F body=@/tmp/pr.md --jq '.html_url'
正文：变更内容、变更原因、您用于检查的操作、以及评审者必须决定的事项。 8. 如果 CI 失败，阅读日志，在同一分支上修复，然后推送。不要在红色状态下合并。 9. 合并顺序：如果 PR 之间存在依赖关系，请在正文中说明，并按顺序合并。
绝对不要提交到 main，绝对不要强制推送共享分支，绝对不要跳过钩子。