القائمة
PR・コミット作法の詳細。タイトル/本文の書き方（一般人向け・用語の言い換え）、UI スクリーンショットの撮り方と添付、skip-ci/skip-post の挙動と例外、本番デプロイの確認手順、環境署名フォーマット。PR 作成・コミット・マージ・デプロイ確認の前に読む。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
実装ガイド。新規ページ追加（ルーティング/コントローラ/ビュー）、DB アクセスパターン、スキーマ変更、DI/ServiceProvider、クローラ設定、フロントエンド（React）のビルドと翻訳、ページ系キャッシュ生成アーキテクチャと genetop の詳細。PHP・フロントのコードを書く/変更する前に読む。
開発環境の起動・操作ガイド。Docker/Makefile コマンド、Mock 環境（LINE Mock API）、Shared mode（別リポと DB 共有）、ポート一覧、Codespaces、CI 環境とプリビルドイメージの詳細。環境の起動・再構築・ローカル確認・CI デバッグの前に読む。
| name | pr-guide |
| description | PR・コミット作法の詳細。タイトル/本文の書き方（一般人向け・用語の言い換え）、UI スクリーンショットの撮り方と添付、skip-ci/skip-post の挙動と例外、本番デプロイの確認手順、環境署名フォーマット。PR 作成・コミット・マージ・デプロイ確認の前に読む。 |
前提: CLAUDE.md の必守ルール（スクショ添付・デプロイ見届け・署名・skip-ci デフォルト方針）に従う。本ガイドはその具体的な手順と書き方。
画面に機能を追加・改修した PR は、実装後の各画面のスクリーンショットを PR 本文に貼る。文章だけだと レビュー側がどんな見た目になるか判断できないため。
.env の HTTPS_PORT）を headless Chrome（google-chrome --headless=new --ignore-certificate-errors --screenshot=...）かブラウザで開いて撮る。エラー画面・5xx・空状態など特殊な
状態は、対象エンドポイントに一時的に例外を throw する等で再現してから撮り、撮影後に必ず元へ戻す。assets/pr-screenshots 等）は作らない（2026-06-27 ユーザー指示）。PR をマージして終わりにしない。本番デプロイ（deploy.yml の Deploy job）が success になるまで見届けてから「完了」と報告する。マージ＝デプロイ成功ではない（別 PR が deploy.yml 等に残した不整合で本番デプロイだけが落ちることがある）。
gh run list --workflow=deploy.yml --limit 4 で該当 Deploy run を特定し、gh run view <id> --json status,conclusion を completed/success までポーリングする。本番かどうかの確実な見分け方は env IS_STG: false（run タイトルの [PROD] は pr-title-prefix.yml が main 向け PR タイトルに自動付与したもの）。GitHub に投稿する本文（PR 本文・issue・PR/issue コメント等）の末尾に、区切り線を入れて以下の署名ブロックを付ける。どのマシン・ディレクトリから、どのモデル・ツールで投稿されたかを残すため。
---
🤖 Generated with Claude Code (<モデルID>)
Posted from: `<hostname>:<作業ディレクトリ>`
モデルはその時のセッションの実際のモデル ID を書く（表示名は省く。例: Opus 4.8 → claude-opus-4-8[1m]）
<hostname> は hostname、<作業ディレクトリ> は pwd の値だがホームディレクトリは ~ に短縮する（例: /home/user/repos/Open-Chat-Graph → user-B550M-Pro4:~/repos/Open-Chat-Graph）
コミットメッセージにも毎回 環境署名を入れる（PR/issue/コメント本文だけでなく、全コミット）。末尾に署名2行を付ける。Co-Authored-By: Claude ... は 🤖 行とモデル情報が重複するので付けない（全廃）:
<コミット本文>
🤖 Generated with Claude Code (claude-opus-4-8[1m])
Committed from: user-B550M-Pro4:~/repos/Open-Chat-Graph
~ 短縮、リポごとに実ディレクトリを書く）。IMPORTANT: PR タイトルは SNS に自動投稿されるため、一般人に伝わる書き方にする。
❌ BAD:
perf: dailyTask処理時間の大幅短縮とタイムアウト問題の解決
fix: getMemberChangeWithinLastWeekCacheArray()の重複実行を防止
✅ GOOD:
perf: 日次データ更新処理のタイムアウト問題を解決（9〜11時間→1〜2時間）
fix: 統計データ抽出クエリの重複実行を防止してDB負荷を軽減
ガイドライン:
構成:
例:
## 問題の概要
オープンチャットの日次データ更新処理が9〜11時間かかり完了しない
### 具体的な問題
全statisticsテーブル（8700万行）から「メンバー数が変動している部屋」を抽出する処理が、
以下の2箇所で重複実行されている:
- クローリング対象の絞り込み処理 ([`DailyUpdateCronService::getTargetOpenChatIdArray()`](link))
- ランキング用キャッシュ保存処理 ([`UpdateHourlyMemberRankingService::saveFiltersCacheAfterDailyTask()`](link))
## 対処内容
クエリ結果をプロパティに保存し、2回目で再利用
CI Test (ci.yml) は Mock 環境のクローリング＋URLテストのみで、phpunit は実行しない。
これらが意味を持たない変更（typo・ドキュメント・デプロイ時にだけ動くロジック等）では CI を飛ばせる:
skip-ci ラベルを付けるskip-ci: 始まりにする（例: skip-ci: Fix typo in README）デフォルト方針（PHP を触らない PR は skip-ci）:
CI(ci.yml)は Mock 環境のクローリング＋URLテストなので、その挙動は基本的に PHP 側で決まる。
そのため PHP コードを一切変更していない PR は、デフォルトで skip-ci にする（フロント JS/CSS・
ドキュメント・翻訳 JSON 等だけの変更）。確実に効かせるため PR タイトルを skip-ci: 始まりにする
（ラベルだけは PR 作成時にレースして効かないことがある。既存 PR に後付けする場合は、ラベルを
付けてから次の push をすると synchronize で再評価されて効く）。
注意: stg/main 向け PR はタイトル先頭に [STG]/[PROD] が自動付与される（pr-title-prefix.yml）ため、
付与後の push ではタイトル判定が効かなくなる。確実なのは「タイトル skip-ci: 始まり（opened 時に判定される）
＋ skip-ci ラベル（deploy ゲート用）」の併用。
例外（PHP を触っていなくても skip-ci を付けない）:
ci.yml/docker-compose.ci.yml)自体の変更skip-ci 使用時の挙動:
ci.yml の Mock クローリング＋URLテスト）がスキップされるdeploy.yml の「Check CI status」ゲートも飛ばされる（CI 成功を要求しなくなる）stg を head にした PR は skip-ci 無しでも CI が自動スキップされる（ci.yml）マージ後の X (Twitter) 自動投稿だけをスキップする（CI とデプロイは走る）:
skip-post ラベルを付けるskip-post: 始まりにする（例: skip-post: Internal configuration update）X 自動投稿はリリース履歴を兼ねるため、skip-post を自己判断で付けない（ユーザー指示があるときだけ）。
.github/workflows/x-post.yml（workflow_dispatch）に text を渡して実行すると、
@openchat_graph に任意の本文をそのまま投稿できる（\n は改行に変換される）。
告知・紹介など「PRマージのお知らせ」形式にしたくない投稿はこちらを使う。
URL を含めると X API の従量課金が上がる（URL 無し $0.015 / 有り $0.20）。投稿はユーザー指示があるときだけ。