Git と PR のワークフロー
- 同期:
git fetch origin main && git checkout main && git reset --hard FETCH_HEAD（クローンは shallow の場合があり、origin/mainが解決できないことがあります）。 - ブランチ作成: スプリントチケットの場合は
git checkout -b S<n>/<area>/<slug>（docs/sprints/を参照）、それ以外はfix/、docs/またはchore/にスラッグを付けて作成します。 - 小さなコミットで作業を進めます。各コミットの前に
AGENTS.mdの「コマンド」セクションを確認します。 - 同じ PR 内で
docs/HANDOFF.mdを更新します（スキルhandoffを使用）。 - コミットメッセージ:
型(スコープ): 命令形の要約
なぜこの変更が必要か（1～2文で）
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 にコミットしない、共有ブランチに強制プッシュしない、フックをスキップしないでください。