Sunwood-AI-OSS-Hub Repo Manager
ユーザーからのリクエストをタスク分割して Issue 登録・プロジェクト管理・親子関係設定・進捗報告します。
モジュール構成: plan + analyze-diff + project-mgmt + repo-flow
前提条件
- GitHub CLI (
gh) がインストール済み gh auth loginで認証済み- サブイシュー機能が有効化されている（Organization設定）
除外条件
プライベートリポジトリの場合は、このフローを実行しません。
# リポジトリの可視性を確認
gh repo view --json visibility,owner,name
# visibility: "PRIVATE" の場合はスキップ
省略オプション
何回も使う場合、プロジェクトURLを毎回指定するのは手間です。以下の省略方法が利用できます。
デフォルトプロジェクト
プロジェクトURLを省略した場合、現在のリポジトリのデフォルトプロジェクトを使用します。
# 環境変数でデフォルトプロジェクトを設定
export REPO_MANAGER_DEFAULT_PROJECT="orgs/Sunwood-AI-OSS-Hub/projects/2"
# 省略形の呼び出し
/repo-manager ユーザー認証機能を追加して
短いエイリアス
よく使うパターンには短いエイリアスを用意しています。
/reg-issue # 計画からIssueを作成 + プロジェクトに登録（plan + project-mgmt）
/plan # 計画からIssueを作成（Issue作成のみ）
/reg-commit # 差分からIssueを作成 + プロジェクトに登録 + コミット＆プッシュ（analyze-diff + plan + project-mgmt + repo-flow）
/task # タスク管理（repo-managerのエイリアス）
使用例
# 完全指定
ユーザー: 「https://github.com/orgs/Sunwood-AI-OSS-Hub/projects/2/views/1 に、ユーザー認証機能を追加して」
# 省略形（デフォルトプロジェクトを使用）
ユーザー: 「/reg-issue ユーザー認証機能を追加して」
# さらに省略
ユーザー: 「ユーザー認証機能」
ワークフロー
パターン1: 計画からタスク登録
アイデア/要望があって、まだ実装していないタスクをIssueとして登録したい場合のフロー。
フロー: plan → project-mgmt
┌─────────────────────────────────────────────────────────────┐
│ 1. plan モジュール │
│ - 要望のヒアリング │
│ - タスク分割 │
│ - Issue 作成（親子構造） │
│ - 親子関係の設定 │
├─────────────────────────────────────────────────────────────┤
│ 2. project-mgmt モジュール │
│ - プロジェクトへの追加 │
│ - ステータス設定（Todo） │
│ - 日付設定 │
└─────────────────────────────────────────────────────────────┘
実行手順:
plan スキルを呼び出す
/planスキルでタスク分割とIssue作成を実行- 親Issueとサブイシューが作成される
project-mgmt スキルを呼び出す
- 作成したIssueをプロジェクトに追加
- ステータスを「Todo」に設定
- 開始日と終了日を設定
パターン2: 差分からタスク登録
既にコードを書いていて、その変更をIssueとして登録し、コミット＆プッシュまで行う場合のフロー。
フロー: analyze-diff → plan → project-mgmt → repo-flow
┌─────────────────────────────────────────────────────────────┐
│ 1. analyze-diff モジュール │
│ - 現在の差分を解析（git status, git diff） │
│ - タスク分割案の作成 │
├─────────────────────────────────────────────────────────────┤
│ 2. plan モジュール │
│ - タスク分割 │
│ - Issue 作成（親子構造） │
│ - 親子関係の設定 │
├─────────────────────────────────────────────────────────────┤
│ 3. project-mgmt モジュール │
│ - プロジェクトへの追加 │
│ - ステータス設定（Done） │
│ - 日付設定 │
├─────────────────────────────────────────────────────────────┤
│ 4. repo-flow モジュール │
│ - ブランチ作成 │
│ - コミット（Issue番号を含める） │
│ - プッシュ │
│ - PR 作成 │
│ - develop へマージ │
│ - クリーンアップ │
└─────────────────────────────────────────────────────────────┘
実行手順:
analyze-diff スキルを呼び出す
/diffスキルで現在の差分を解析- タスク分割案を作成
plan スキルを呼び出す
- タスク分割案に基づいてIssueを作成
- 親子関係を設定
project-mgmt スキルを呼び出す
- 作成したIssueをプロジェクトに追加
- ステータスを「Done」に設定
- 開始日と終了日を設定
repo-flow スキルを呼び出す
/repo-flowスキルでコミット＆プッシュ- Issue番号を含めてコミット（自動クローズ）
- PR作成、developへのマージ、クリーンアップ
使用例
計画からタスク登録（パターン1）
ユーザー: 「https://github.com/orgs/Sunwood-AI-OSS-Hub/projects/2/views/1 に、次の計画をIssueとして登録して：
- ユーザー認証機能の追加
- 管理者ダッシュボードの作成
- APIドキュメントの整備」
スキル:
1. /plan スキルを呼び出し:
- タスク分割（親Issue + サブイシュー）
- 親Issueを作成
- 各サブイシューを作成
- 親子関係を設定
2. /project-mgmt スキルを呼び出し:
- プロジェクトに追加
- ステータスを Todo に設定
- 日付を設定
差分からタスク登録（パターン2）
ユーザー: 「https://github.com/orgs/Sunwood-AI-OSS-Hub/projects/2/views/1 のプロジェクトに差分からタスクを登録して」
スキル:
1. /diff スキルを呼び出し（analyze-diff）:
- 現在の差分を解析（git status, git diff）
2. /plan スキルを呼び出し:
- タスク分割（親Issue + サブイシュー）
- 親Issueを作成
- 各サブイシューを作成
- 親子関係を設定
3. /project-mgmt スキルを呼び出し:
- プロジェクトに追加
- ステータスと日付を設定
4. /repo-flow スキルを呼び出し:
- コミット（Issue番号を含めて）
- プッシュ
- PR作成
- developへのマージ
- クリーンアップ
基本的な使用例
ユーザー: 「GitHub Actions のワークフローを設定して」
スキル:
1. /plan スキルを呼び出し:
- タスク分割:
- 親Issue: CI/CD環境の構築
- Sub-1: GitHub Actions の基本設定
- Sub-2: CI/CD パイプラインの構築
- Sub-3: テスト自動化の追加
- 親Issue & サブイシューを作成
- 親子関係を設定
2. /project-mgmt スキルを呼び出し:
- プロジェクトに追加
- ステータス設定（Todo）
- 日付設定（開始日・終了日）
モジュール詳細
各モジュールの詳細は以下を参照してください：
| モジュール | 説明 | ドキュメント |
|---|---|---|
| plan | タスク分割 → Issue作成 → 親子関係設定 | .claude/skills/plan/SKILL.md |
| analyze-diff | 差分解析 → タスク分割 | .claude/skills/analyze-diff/SKILL.md |
| project-mgmt | プロジェクト追加・ステータス設定・日付設定 | .claude/skills/project-mgmt/SKILL.md |
| repo-flow | ブランチ作成・コミット・プッシュ・PR・マージ | .claude/skills/repo-flow/SKILL.md |
ステータス遷移
Todo → In Progress → Done
↑ │
└─────────┘
(中断時)
注意点
- プライベートリポジトリ: このフローを実行せず、通常の開発モードで作業
- プロジェクトID: 固定IDに依存せず、動的に取得する
- サブイシュー:
sub_issue_idには Issue番号ではなくdatabaseIdを使用する - サブイシュー機能: Organizationで有効化されている必要がある
- タスク粒度: サブイシューは 1-2 日で完了できる粒度に分割
- 日付設定: Issue 作成後、必ず開始日と終了日を設定すること（YYYY-MM-DD形式）
- コミットメッセージ:
Closes #番号を含めると自動的にIssueがクローズされる
参照
詳細な使用例とトラブルシューティング:
- references/EXAMPLES.md - 完全実例とエラー解決策
GitHub プロジェクト管理のコマンド詳細は project-mgmt スキルを参照してください:
- .claude/skills/project-mgmt/SKILL.md - プロジェクト管理スキル
- .claude/skills/project-mgmt/references/COMMANDS.md - コマンド詳細
- .claude/skills/project-mgmt/references/EXAMPLES.md - 使用例
repo-manager は各モジュールを組み合わせてタスク分割・進捗管理を行います。