Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:51:38 +08:00
commit 8b9cbcdff7
18 changed files with 3489 additions and 0 deletions

139
commands/branch.md Normal file
View File

@@ -0,0 +1,139 @@
---
name: branch
description: ブランチを管理する
---
# Branch
## 概要
このコマンドは、Gitブランチの管理を行う。ブランチ作成、切り替え、削除、一覧表示などの操作を対話的に実行し、開発フローにおけるブランチ運用を効率化する。
## 使用するエージェント
- **version-control-agent:** Git操作およびGitHub操作全般を管理する
## 使用するスキル
1. **version-control-guidelines:** Git運用のガイドラインに従う
2. **interaction-guidelines:** ユーザーとの効果的な対話パターンに従う
## 実行フロー
1. version-control-agentが以下のスキルを使用して、ユーザーに実行したい操作を確認する作成、切り替え、削除、一覧表示など
- interaction-guidelines対話パターン
2. **ブランチ作成の場合:**
1. version-control-agentが以下のスキルを使用して、現在のブランチを確認するgit branch --show-current
- version-control-guidelinesGit運用ガイドライン
2. version-control-agentが以下のスキルを使用して、新しいブランチ名をユーザーから取得する
- interaction-guidelines対話パターン
3. version-control-agentが以下のスキルを使用して、ブランチ命名規則に準拠しているか検証する
- version-control-guidelinesGit運用ガイドライン
4. version-control-agentが以下のスキルを使用して、ベースブランチを確認する
- interaction-guidelines対話パターン
5. version-control-agentが以下のスキルを使用して、ブランチを作成するgit branch
- version-control-guidelinesGit運用ガイドライン
6. version-control-agentが以下のスキルを使用して、作成後に切り替えるか確認し、必要に応じて切り替えるgit switch
- interaction-guidelines対話パターン
- version-control-guidelinesGit運用ガイドライン
7. version-control-agentが以下のスキルを使用して、結果をユーザーに報告する
- interaction-guidelines対話パターン
3. **ブランチ切り替えの場合:**
1. version-control-agentが以下のスキルを使用して、現在のブランチの変更状態を確認するgit status
- version-control-guidelinesGit運用ガイドライン
2. version-control-agentが以下のスキルを使用して、未コミットの変更がある場合、対処方法を確認するコミット、スタッシュ、破棄など
- interaction-guidelines対話パターン
3. version-control-agentが以下のスキルを使用して、切り替え先のブランチ名を確認する
- interaction-guidelines対話パターン
4. version-control-agentが以下のスキルを使用して、ブランチを切り替えるgit switch
- version-control-guidelinesGit運用ガイドライン
5. version-control-agentが以下のスキルを使用して、結果をユーザーに報告する
- interaction-guidelines対話パターン
4. **ブランチ削除の場合:**
1. version-control-agentが以下のスキルを使用して、削除するブランチ名を確認する
- interaction-guidelines対話パターン
2. version-control-agentが以下のスキルを使用して、削除対象のブランチがマージ済みか確認する
- version-control-guidelinesGit運用ガイドライン
3. version-control-agentが以下のスキルを使用して、未マージの場合は警告を表示し、強制削除するか確認する
- interaction-guidelines対話パターン
4. version-control-agentが以下のスキルを使用して、ブランチを削除するgit branch -d または -D
- version-control-guidelinesGit運用ガイドライン
5. version-control-agentが以下のスキルを使用して、リモートブランチも削除するか確認する
- interaction-guidelines対話パターン
6. version-control-agentが以下のスキルを使用して、必要に応じてリモートブランチを削除するgit push origin --delete
- version-control-guidelinesGit運用ガイドライン
7. version-control-agentが以下のスキルを使用して、結果をユーザーに報告する
- interaction-guidelines対話パターン
5. **ブランチ一覧表示の場合:**
1. version-control-agentが以下のスキルを使用して、表示範囲を確認するローカル、リモート、全て
- interaction-guidelines対話パターン
2. version-control-agentが以下のスキルを使用して、ブランチ一覧を取得して表示するgit branch、git branch -r、git branch -a
- version-control-guidelinesGit運用ガイドライン
3. version-control-agentが以下のスキルを使用して、現在のブランチを強調表示する
- interaction-guidelines対話パターン
## 成果物
**出力先:**
- ローカルリポジトリのブランチ構成が変更される
- リモートリポジトリのブランチ構成が変更される(削除時など)
**成果物の内容(作成時):**
- 新しいブランチ名
- ベースブランチ情報
- 現在のブランチ(切り替えた場合)
**成果物の内容(削除時):**
- 削除されたブランチ名
- ローカル/リモートの削除状況
## チェックリスト
### コマンド実行前(作成時)
- [ ] ブランチ名が命名規則に準拠している
- [ ] 適切なベースブランチから作成する
- [ ] 同名のブランチが存在しない
### コマンド実行後(作成時)
- [ ] ブランチが正常に作成された
- [ ] 必要に応じて新しいブランチに切り替えられた
- [ ] ブランチ名が正しい
### コマンド実行前(削除時)
- [ ] 削除対象のブランチがマージ済みである(未マージの場合は意図的)
- [ ] 削除対象のブランチが正しい
- [ ] 現在のブランチが削除対象ではない
### コマンド実行後(削除時)
- [ ] ブランチが正常に削除された
- [ ] 必要に応じてリモートブランチも削除された
- [ ] ブランチ一覧から削除されている

68
commands/commit.md Normal file
View File

@@ -0,0 +1,68 @@
---
name: commit
description: 変更をコミットする
---
# Commit
## 概要
このコマンドは、ワークツリーの変更をローカルリポジトリにコミットする。変更内容の確認、適切なコミットメッセージの作成、コミットの実行までを一貫して管理し、バージョン管理のベストプラクティスに従った運用を実現する。
## 使用するエージェント
- **version-control-agent:** Git操作およびGitHub操作全般を管理する
## 使用するスキル
1. **version-control-guidelines:** Git運用のガイドラインに従う
## 実行フロー
1. version-control-agentが以下のスキルを使用して、現在の変更状況を確認するgit status
- version-control-guidelinesGit運用ガイドライン
2. version-control-agentが以下のスキルを使用して、変更内容の詳細を確認するgit diff
- version-control-guidelinesGit運用ガイドライン
3. version-control-agentが以下のスキルを使用して、規約に準拠したコミットメッセージを作成する
- version-control-guidelinesGit運用ガイドライン
4. version-control-agentが以下のスキルを使用して、変更をステージングするgit add
- version-control-guidelinesGit運用ガイドライン
5. version-control-agentが以下のスキルを使用して、コミットを実行するgit commit
- version-control-guidelinesGit運用ガイドライン
6. version-control-agentが以下のスキルを使用して、コミット結果をユーザーに報告する
- interaction-guidelines対話パターン
## 成果物
**出力先:**
- ローカルリポジトリ(.gitディレクトリにコミットオブジェクトが作成される
**成果物の内容:**
- コミットハッシュ
- コミットメッセージ
- 変更されたファイルのリスト
- 作成者情報
- タイムスタンプ
## チェックリスト
### コマンド実行前
- [ ] 変更内容が意図したものであることを確認した
- [ ] コミット対象のファイルが明確である
- [ ] コミットメッセージの内容を考えている
### コマンド実行後
- [ ] コミットが正常に作成された
- [ ] コミットメッセージが規約に準拠している
- [ ] 適切なファイルがコミットに含まれている
- [ ] 機密情報が含まれていない
- [ ] コミット履歴が適切に記録されている

96
commands/issue.md Normal file
View File

@@ -0,0 +1,96 @@
---
name: issue
description: Issueを管理する
---
# Issue
## 概要
このコマンドは、GitHub Issueの管理を行う。Issue作成、一覧表示、詳細確認、クローズなどの操作を対話的に実行し、タスク管理やバグ報告のワークフローを効率化する。
## 使用するエージェント
- **version-control-agent:** Git操作およびGitHub操作全般を管理する
## 使用するスキル
1. **issue-management-guidelines:** Issue管理のガイドラインに従う
2. **interaction-guidelines:** ユーザーとの効果的な対話パターンに従う
## 実行フロー
1. version-control-agentが以下のスキルを使用して、ユーザーに実行したい操作を確認する作成、一覧、表示、クローズなど
- interaction-guidelines対話パターン
2. **Issue作成の場合:**
1. version-control-agentが以下のスキルを使用して、Issueのタイプを確認するバグ報告、機能要望、タスクなど
- issue-management-guidelinesIssue管理ガイドライン
2. version-control-agentが以下のスキルを使用して、適切なテンプレートを選択する
- issue-management-guidelinesIssue管理ガイドライン
3. version-control-agentが以下のスキルを使用して、必要な情報をユーザーから収集するタイトル、説明、再現手順など
- interaction-guidelines対話パターン
4. version-control-agentが以下のスキルを使用して、規約に準拠したIssueを作成するgh issue create
- issue-management-guidelinesIssue管理ガイドライン
5. version-control-agentが以下のスキルを使用して、作成されたIssueのURLと番号をユーザーに報告する
- interaction-guidelines対話パターン
3. **Issue一覧表示の場合:**
1. version-control-agentが以下のスキルを使用して、フィルタ条件を確認する状態、ラベル、担当者など
- interaction-guidelines対話パターン
2. version-control-agentが以下のスキルを使用して、Issueの一覧を取得して表示するgh issue list
- issue-management-guidelinesIssue管理ガイドライン
4. **Issue詳細表示の場合:**
1. version-control-agentが以下のスキルを使用して、表示するIssue番号を確認する
- interaction-guidelines対話パターン
2. version-control-agentが以下のスキルを使用して、Issueの詳細を取得して表示するgh issue view
- issue-management-guidelinesIssue管理ガイドライン
5. **Issueクローズの場合:**
1. version-control-agentが以下のスキルを使用して、クローズするIssue番号を確認する
- interaction-guidelines対話パターン
2. version-control-agentが以下のスキルを使用して、クローズ理由を確認する完了、重複、無効など
- interaction-guidelines対話パターン
3. version-control-agentが以下のスキルを使用して、Issueをクローズするgh issue close
- issue-management-guidelinesIssue管理ガイドライン
## 成果物
**出力先:**
- GitHubリポジトリにIssueが作成・更新される
**成果物の内容(作成時):**
- Issue番号とURL
- Issueタイトル
- Issue本文説明、再現手順、期待動作など
- ラベルbug、enhancement、taskなど
- マイルストーン(設定した場合)
- 担当者(設定した場合)
## チェックリスト
### コマンド実行前(作成時)
- [ ] Issueの目的が明確である
- [ ] 適切なテンプレートを選択できる
- [ ] 必要な情報が揃っている(タイトル、説明など)
- [ ] 重複するIssueがないか確認した
### コマンド実行後(作成時)
- [ ] Issueが正常に作成された
- [ ] タイトルと説明が規約に準拠している
- [ ] 適切なラベルが設定されている
- [ ] 必要に応じて担当者が設定されている
- [ ] Issue番号を記録した

77
commands/pr.md Normal file
View File

@@ -0,0 +1,77 @@
---
name: pr
description: プルリクエストを作成する
---
# Pull Request
## 概要
このコマンドは、現在のブランチの変更をベースブランチにマージするためのプルリクエストを作成する。ブランチの状態確認、コミット履歴の分析、適切なPR情報の作成、GitHubへのPR公開までを一貫して管理し、コードレビューとマージのプロセスを円滑に進める。
## 使用するエージェント
- **version-control-agent:** Git操作およびGitHub操作全般を管理する
## 使用するスキル
1. **version-control-guidelines:** Git運用のガイドラインに従う
2. **interaction-guidelines:** ユーザーとの効果的な対話パターンに従う
## 実行フロー
1. version-control-agentが以下のスキルを使用して、現在のブランチ状態を確認するgit status、git branch
- version-control-guidelinesGit運用ガイドライン
2. version-control-agentが以下のスキルを使用して、リモートとの同期状態を確認するgit fetch、git status
- version-control-guidelinesGit運用ガイドライン
3. version-control-agentが以下のスキルを使用して、ブランチがリモートにpushされていない場合、ユーザーにpushを促す
- interaction-guidelines対話パターン
4. version-control-agentが以下のスキルを使用して、ベースブランチからのコミット履歴を確認するgit log、git diff
- version-control-guidelinesGit運用ガイドライン
5. version-control-agentが以下のスキルを使用して、ユーザーと対話しながら変更の目的や影響範囲を確認する
- interaction-guidelines対話パターン
6. version-control-agentが以下のスキルを使用して、規約に準拠したPRタイトルと説明を作成する
- version-control-guidelinesGit運用ガイドライン
7. version-control-agentが以下のスキルを使用して、GitHubにプルリクエストを作成するgh pr create
- version-control-guidelinesGit運用ガイドライン
8. version-control-agentが以下のスキルを使用して、作成されたPRのURLと次のステップをユーザーに報告する
- interaction-guidelines対話パターン
## 成果物
**出力先:**
- GitHubリポジトリにプルリクエストが作成される
**成果物の内容:**
- PR番号とURL
- PRタイトル
- PR説明変更内容、目的、影響範囲など
- ベースブランチとヘッドブランチの情報
- 変更されたファイルのリスト
- コミット履歴
## チェックリスト
### コマンド実行前
- [ ] 変更がコミット済みである
- [ ] ブランチがリモートにpush済みであるまたは実行時にpushする準備がある
- [ ] PRの目的と変更内容が明確である
- [ ] ベースブランチが正しい
### コマンド実行後
- [ ] プルリクエストが正常に作成された
- [ ] PRタイトルと説明が規約に準拠している
- [ ] 適切なベースブランチが設定されている
- [ ] レビュアーの設定が必要な場合は設定されている
- [ ] CI/CDパイプラインが実行されている設定されている場合