Communitygithub.com

Daniel-DB-hub/developer-portfolio

ブランチ作成、ステージング、コミット、プッシュ、リベース、プルリクエストの作成・マージ、リリース準備、またはこのプロジェクトのGitHubリポジトリ設定変更を行う際に使用します。

developer-portfolio とは?

このスキルは、プロジェクトにおけるGitワークフロー全体を標準化・ガバナンスするためのAIエージェント指示セットです。主に`production`ブランチを唯一の長期ブランチとし、直接作業を禁止することで、安定したコードベースを維持します。開発者はすべての書き込み操作前に`git status`で状態確認とリモートのフェッチを行い、`feat/`や`fix/`といったスコープ付きの短命タスクブランチを作成します。コミット前には秘密情報や顧客データの漏洩をチェックし、Conventional Commit形式のメッセージを使用、AI共同作成者の追記は明示的な要求がない限り禁止です。プッシュは決して`production`へ直接行わず、フォースプッシュには`--force-with-lease`を明示承認後にのみ許可し、すべての本番変更はプルリクエスト経由で行います。マージはスカッシュマージのみで、ブランチはマージ後に削除され、マージ承認はRandiによる明示的な承認が必要です。このスキルはクローン操作には適用されず、マージ前にエージェントが停止するガードレールを持ち、完了レポートでブランチ、コミット、チェック結果、機密性レビューなどを報告します。主に対象とするプラットフォームはGitとGitHubであり、Claude CodeやCursorなどのAI Agentツールでの使用を想定しています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Daniel-DB-hub/developer-portfolio/tree/HEAD/.claude/skills/following-git-workflow

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Gitワークフローの遵守

基本ルール

production は唯一の長期間存続するブランチです。直接作業してはいけません。

Gitへの書き込み操作を行う前には必ず:

  1. git status --short --branch を実行する。
  2. 予期しないファイルや変更がないことを確認する。
  3. リモートをフェッチする。
  4. 短期間のタスクブランチを作成または切り替える。
  5. ブランチの目的を1つに限定する。

ブランチ名

以下の命名規則を使用:

  • feat/<scope>
  • fix/<scope>
  • hotfix/<scope>
  • test/<scope>
  • docs/<scope>
  • refactor/<scope>
  • chore/<scope>

小文字のkebab-caseを使用すること。main、dev-production、changes、 update、または同様に曖昧な名前は絶対に使用してはいけません。

コミット前

  1. git diff と git diff --staged を確認する。
  2. 無関係なファイルを削除する。
  3. シークレット、非公開の証拠、内部URL、生のAIセッション、顧客データ、 学生データが含まれている場合は停止する。
  4. 変更範囲に関連するチェックを実行する。
  5. Conventional Commitメッセージを使用する。
  6. 明示的に要求されない限り、AI共同作成者のtrailerを追加しない。

プッシュとプルリクエスト

  • production に直接プッシュしてはいけません。
  • production にフォースプッシュしてはいけません。
  • フックや必要なチェックをバイパスしてはいけません。
  • 単純な --force を使用してはいけません。
  • タスクブランチでは、明示的な承認後にのみ --force-with-lease を使用する。
  • 本番環境への変更はすべてプルリクエストを経由します。
  • .github/pull_request_template.md に従う。

マージの境界

Randiが現在の会話内で特定のプルリクエストのマージを明示的に承認しない限り、 Claudeはマージの前に停止しなければなりません。

スカッシュマージのみ使用すること。マージ後はタスクブランチを削除する。

完了レポート

以下を報告:

  • ブランチ
  • コミット
  • 実行したチェックとその結果
  • プルリクエストの状態
  • 機密性のレビュー
  • 残存リスク
  • マージ承認がまだ必要かどうか

完全なポリシー

以下を読み、従うこと:

  • docs/governance/git-workflow.md
  • docs/governance/github-configuration.md

関連スキル