القائمة
このリポジトリでの開発フロー（GitHub Flow）を定義するスキル。feature ブランチの作成から Draft PR、レビュー、Squash Merge までの一連の作業手順とルールを示します。コードを変更する作業を行う場合は、必ずこのスキルに従ってください。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Prompt for creating the high-level technical architecture for an Epic, based on a Product Requirements Document.
Modular Monolith + Clean Architecture の設計ガイド。新しいモジュールの作成、画面の実装、機能追加を行う際には、必ずこのスキルを参照して従ってください。
Create a new specification as a GitHub Issue, optimized for Generative AI consumption.
ドキュメント作成時の共通ルール。Markdown ドキュメントを新規作成・更新する際には、必ずこのスキルを参照して従ってください。
Ensure .NET/C# code meets best practices for the solution/project.
playwright-cli を使った E2E テストの実行スキル。ブラウザを headless モードで起動し、テスト結果をスクリーンショットとして screenshots/ 配下の日付付きフォルダーに保存する。E2E テストを実行する際には、必ずこのスキルに従ってください。
| name | github-flow |
| description | このリポジトリでの開発フロー（GitHub Flow）を定義するスキル。feature ブランチの作成から Draft PR、レビュー、Squash Merge までの一連の作業手順とルールを示します。コードを変更する作業を行う場合は、必ずこのスキルに従ってください。 |
このリポジトリでは GitHub Flow を採用しています。すべてのコード変更は、以下のフローに従って行ってください。
main（保護ブランチ）
│
├─ feature/<issue番号>-<短い説明> ブランチを作成
│ ├─ 作業・コミット（Conventional Commits）
│ ├─ dotnet build / dotnet test で品質確認
│ └─ Draft PR を作成
│ ├─ 作業完了後 → Ready for Review に変更
│ ├─ レビュー実施
│ └─ Squash Merge → main へ統合
│
└─ ブランチ削除
main ブランチから feature ブランチを切ります。直接 main にコミットしてはいけません。
feature/<issue番号>-<短い説明>
| 例 | 説明 |
|---|---|
feature/42-add-search | Issue #42 に対応する検索機能追加 |
feature/15-fix-pagination | Issue #15 のページネーション不具合修正 |
git switch main
git pull origin main
git switch -c feature/42-add-search
すべてのコミットメッセージは Conventional Commits に従います。
<type>(<scope>): <description>
[本文（任意）]
[フッター（任意）]
| type | 用途 |
|---|---|
feat | 新機能の追加 |
fix | バグ修正 |
docs | ドキュメントのみの変更 |
style | コードの意味に影響しない変更（空白、フォーマット等） |
refactor | バグ修正でも機能追加でもないコード変更 |
test | テストの追加・修正 |
chore | ビルドプロセスや補助ツールの変更 |
プロジェクトのモジュール構成に応じて scope を定義します。以下は典型的な例です。
| scope | 対象 |
|---|---|
<module> | 対象モジュール全般 |
<module>-domain | .Domain プロジェクト |
<module>-app | .Application プロジェクト |
<module>-infra | .Infrastructure プロジェクト |
web | Web プロジェクト（Blazor UI） |
apphost | AppHost プロジェクト（Aspire） |
skill | GitHub Copilot スキル |
feat(orders): 注文一覧の検索機能を追加
GetOrdersUseCase に検索パラメータを追加し、
リポジトリの検索メソッドを実装した。
Refs #42
fix(web): 一覧画面のページネーションが正しく動作しない問題を修正
Refs #15
PR を作成する前に、必ずローカルでビルドとテストを実行して成功を確認してください。
cd src
dotnet build <YourSolution>.slnx
dotnet test <YourSolution>.slnx
注意: ビルドエラーやテスト失敗がある状態で PR を作成しないでください。
新規・変更したビジネスロジックには 単体テストを必ず作成 してください。
csharp-mstest スキルを参照clean-architecture-guide スキルを参照<ModuleName>.Application.Tests プロジェクトに配置するfeature ブランチをリモートにプッシュし、Draft Pull Request を作成します。
git push -u origin feature/42-add-search
Conventional Commits と同じ形式にします。
feat(orders): 注文一覧の検索機能を追加
## 概要
<!-- 変更の目的と背景を簡潔に記述 -->
## 変更内容
<!-- 主な変更点を箇条書きで記述 -->
-
-
## 関連 Issue
<!-- 対応する Issue を記載 -->
Closes #<issue番号>
## 確認事項
- [ ] `dotnet build <YourSolution>.slnx` が成功する
- [ ] `dotnet test <YourSolution>.slnx` が成功する
- [ ] 新規・変更したビジネスロジックに単体テストがある（`csharp-mstest` スキル参照）
- [ ] テストプロジェクトの配置が規約に従っている（`clean-architecture-guide` スキル参照）
作業が完了したら以下を行います。
Squash and Merge を使用します。
main ブランチの履歴がクリーンに保たれるgit switch main
git pull origin main
git branch -d feature/42-add-search
| やってはいけないこと | 代わりにやること |
|---|---|
main ブランチに直接コミット | feature ブランチを作成してから作業 |
| ビルドが通らない状態で PR 作成 | dotnet build / dotnet test を先に実行 |
Force push を main に実行 | feature ブランチでのみ必要に応じて使用 |
| レビューなしでマージ | 必ずレビュー承認を経てからマージ |
| Merge commit や Rebase merge | Squash Merge を使用 |
# 1. ブランチ作成
git switch main && git pull origin main
git switch -c feature/<issue番号>-<説明>
# 2. 作業・コミット
git add .
git commit -m "feat(<scope>): 変更内容の説明"
# 3. ビルド確認
cd src && dotnet build <YourSolution>.slnx && dotnet test <YourSolution>.slnx
# 4. プッシュ & Draft PR 作成
git push -u origin feature/<issue番号>-<説明>
# GitHub で Draft PR を作成
# 5. 完了後 → Ready for Review → レビュー → Squash Merge
# 6. マージ後のクリーンアップ
git switch main && git pull origin main
git branch -d feature/<issue番号>-<説明>