القائمة
パッチバグフィクス以外の実装作業を行うときに必ず参照する。Issue 起票、専用ブランチ作成、実装、PR 作成、同期状態確認、ahead/behind がない場合のみマージする標準フローを定義する。巨大モノレポ、複数会社・複数人で同時実装する状況、機能追加、仕様変更、リファクタリング、設計変更、依存関係変更、DB/API/UI/アーキテクチャ変更で使用する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
既存スキルに従って作業しても期待通り進まないとき、Web 検索などで異なる情報・より新しい情報が得られたとき、スキルの条件分岐を厳守するとスタックや実装の自由度が制限され最良の結果が得られないと判断したときに参照する。`.agents/skills/<name>/SKILL.md` をローカルで改変する手順、および改変内容が有用と判断した場合に `philtzjp/skills` リポジトリへ変更提案 Issue を起票する手順とテンプレートを定義する。
API エンドポイントの設計・実装・変更を行うとき（HTTP ハンドラ、OpenAPI スキーマ、ヘルスチェック、ルーティング、認証方式の追加、MCP サーバーの構築など）に参照する。OpenAPI 準拠、RFC 9457 エラー、パスバージョニング、Bearer 認証（loopback サービスは Origin 検証で代替可）、Spectral リント、HTTP サーバー層の統一と MCP トランスポートの選定を定義する。
コミット、プッシュ、ブランチ作成/切り替え/削除、マージ、リベース、`gh pr merge` による PR マージなどあらゆる Git / GitHub 操作を行うときに参照する。コミットメッセージのフォーマット (`type(scope): 説明`)、マージコミット件名 (`merge(scope): 説明`) の `--subject` / `--body ""` 指定、`--author` の扱い、`git fetch --prune` などの安全チェック、マージコミット件名・本文への PR/Issue 番号 (`#N`) 禁止、`Co-Authored-By` 禁止、`git add .` 禁止などを定義する。
スキルの追加・削除・リネーム時、`.claude/skills/` のシンボリックリンクが切れている疑いがあるとき、`AGENTS.md` / `CLAUDE.md` のスキル表とディレクトリ実体が乖離しているとき、上流リポジトリ (`philtzjp/skills`) からスキル定義を取り込み直すときに参照する。`.agents/skills/<name>/SKILL.md`（正本）、`.claude/skills/<name>`（相対シンボリックリンク）、`AGENTS.md` / `CLAUDE.md` のスキル表の三者を整合させる検査・修復手順、および上流からの同期手順を定義する。
上流リポジトリ (`philtzjp/skills`) から自プロジェクトへスキル群を導入する際、新規スキルを採用するか判断する際、既存スキルが自プロジェクトで不要になり除外する際に参照する。プロジェクトの技術スタック・運用ルール・チーム慣習に照らして必要なスキルのみを残し、`AGENTS.md` / `CLAUDE.md` のスキル表と `.agents/skills/` / `.claude/skills/` 配下を一致させる選定手順を定義する。
新規パッケージの追加、`turbo.json` / `pnpm-workspace.yaml` / `tsconfig` の編集、`apps/` や `packages/` の構成変更、責務パッケージ（`log` / `error` / `prompt` / `env` / `db`）の配置・参照を行うときに参照する。Turborepo + pnpm のベストプラクティス、`workspace:*` プロトコル、JIT コンパイル方針を定義する。
| name | issue-branch-pr-flow |
| description | パッチバグフィクス以外の実装作業を行うときに必ず参照する。Issue 起票、専用ブランチ作成、実装、PR 作成、同期状態確認、ahead/behind がない場合のみマージする標準フローを定義する。巨大モノレポ、複数会社・複数人で同時実装する状況、機能追加、仕様変更、リファクタリング、設計変更、依存関係変更、DB/API/UI/アーキテクチャ変更で使用する。 |
commit-and-git スキルも併用する以下のすべてを満たす場合のみ、パッチバグフィクスとしてこのフローを省略できる:
git status --short --branch で作業ツリー、現在ブランチ、upstream 状態を確認するgit fetch --prune を実行する- [ ] チェックボックス）で記述し、達成状況を追跡・チェック可能にする<type>/<issue-number>-<short-kebab-summary> にするtype は feat、fix、refactor、docs、test、chore、ci、build のいずれかにするCloses / Fixes / Resolves + #N 等）を PR 本文で使わない; NOTE: GitHub の自動クローズは英語キーワード専用で日本語では発火しないため、対象 Issue はマージ後に手動でクローズする（自動クローズが必要な場合は PR 作成時に GitHub の Development で Issue をリンクする）gh pr create --body "<本文>" または gh pr create --body-file <file> を使用し、PR 本文を明示するCo-Authored-By を含めない。--fill やエディタ生成により Co-Authored-By が混入する可能性がある場合は使用しないgit fetch --prune を再実行するgit status --short --branch でローカルブランチが upstream に対して ahead / behind / diverged していないことを確認するgit fetch --prune と ahead / behind 確認をもう一度行うgh pr merge <番号> --merge --subject "merge(scope): 説明（日本語、短い文）" --body "" で件名と空の本文を明示する; NEVER: デフォルトのマージコミットメッセージ（Merge pull request #N from ...）を使用しない; NEVER: 件名・本文に PR 番号（#N）や Issue 番号など参照を含めない; NEVER: merge プレフィクスでマージであることが明示されるため、説明文に「マージ」と書かない（NG: merge(api): foo をマージ → OK: merge(api): foo を追加）gh issue close <番号>）; IF: PR 作成時に GitHub の Development で Issue をリンクした; THEN MUST: 自動クローズされているか確認する; IF: マージ・レビュー・検証を保留する、または解決が pending; THEN MAY: 対象 Issue をクローズせず開いたまま「保留（pending review）」として状況・再開条件をコメントに記録する（同一事象での Issue 重複起票を防ぐため）; NEVER: 未解決の同一事象について Issue を重複起票しない