---
description: Agent実行用Issueを対話的に作成
---
# Create Issue Command
Agent実行用のIssueをテンプレートベースで対話的に作成します。
## 使用方法
```bash
/create-issue
```
このコマンドを実行すると、対話的にIssue作成のための情報を収集します。
## 対話フロー
### 1. Issue タイトル
```
Issue タイトルを入力してください:
例) ユーザー認証機能の実装
```
### 2. Issue タイプ選択
```
Issue タイプを選択してください:
1. 🆕 feature (新機能)
2. 🐛 bug (バグ修正)
3. ♻️ refactor (リファクタリング)
4. 📝 docs (ドキュメント)
5. ⚡ performance (パフォーマンス改善)
6. 🔒 security (セキュリティ)
7. 🧪 test (テスト追加)
選択 (1-7):
```
### 3. 要件入力
```
要件を入力してください (完了したら空行):
- ログイン画面の実装
- JWT認証の実装
- ユーザーモデルの作成
- ユニットテスト作成
<Enter>
```
### 4. 技術スタック (オプション)
```
使用する技術スタックを入力してください (任意):
例) React, TypeScript, Firebase Auth
```
### 5. 制約事項 (オプション)
```
制約事項があれば入力してください (任意):
例) パスワードリセット機能は別Issueで実装
```
### 6. Agent実行設定
```
Agent自動実行を有効にしますか? (y/n):
```
- `y`: 🤖agent-execute ラベルを自動付与(作成後すぐにAgentが実行開始)
- `n`: 手動でラベルを追加するまでAgent実行しない
### 7. 優先度設定
```
優先度を選択してください:
1. 🔴 High (高)
2. 🟡 Medium (中)
3. 🟢 Low (低)
選択 (1-3):
```
### 8. 担当者指定 (オプション)
```
担当者を指定しますか? (GitHubユーザー名、空でスキップ):
```
## 生成されるIssue
### Issue Body テンプレート
```markdown
# [タイプ] タイトル
## 📋 要件
- [ ] 要件1
- [ ] 要件2
- [ ] 要件3
## 🛠️ 技術スタック
- React
- TypeScript
- Firebase Auth
## ⚠️ 制約事項
- パスワードリセット機能は別Issueで実装
## 📊 成功条件
- [ ] TypeScript エラー: 0件
- [ ] テストカバレッジ: ≥80%
- [ ] 品質スコア: ≥80点
- [ ] セキュリティスキャン: 脆弱性0件
## 🤖 Agent実行設定
- **自動実行**: 有効
- **優先度**: High
- **期待実行時間**: 3-5分
---
**ラベル**: 🤖agent-execute, 🆕feature, 🔴priority-high
🤖 Generated with [Claude Code](https://claude.com/claude-code)
```
## 実行例
### Example 1: 新機能Issue作成
```bash
/create-issue
```
```
🤖 Agent Issue Creator
Issue タイトルを入力してください:
> ユーザープロフィール編集機能
Issue タイプを選択してください:
1. 🆕 feature
...
> 1
要件を入力してください (完了したら空行):
> プロフィール編集画面UI
> プロフィール更新API
> バリデーション実装
> ユニットテスト作成
>
技術スタックを入力してください (任意):
> React, TypeScript, REST API
制約事項があれば入力してください (任意):
> パスワード変更は別機能として実装
Agent自動実行を有効にしますか? (y/n):
> y
優先度を選択してください:
1. 🔴 High
2. 🟡 Medium
3. 🟢 Low
> 2
担当者を指定しますか? (GitHubユーザー名、空でスキップ):
>
✅ Issue作成完了
Issue番号: #123
URL: https://github.com/owner/repo/issues/123
🤖 Agent実行が開始されます (約3-5分)
進捗確認: npm run agents:parallel:exec -- --issue 123 --dry-run
```
### Example 2: バグ修正Issue作成
```bash
/create-issue
```
```
Issue タイトルを入力してください:
> ログイン時にトークンが更新されない
Issue タイプを選択してください:
> 2 (bug)
要件を入力してください:
> トークンリフレッシュロジック修正
> エラーハンドリング追加
> E2Eテスト追加
>
Agent自動実行を有効にしますか? (y/n):
> y
優先度を選択してください:
> 1 (High)
✅ Issue作成完了
Issue番号: #124
URL: https://github.com/owner/repo/issues/124
🚨 優先度: High のため、即座にAgent実行されます
```
## GitHub CLI統合
内部的に `gh` コマンドを使用してIssueを作成します:
```bash
gh issue create \
--title "ユーザープロフィール編集機能" \
--body "$(cat issue-body.md)" \
--label "🤖agent-execute,🆕feature,🟡priority-medium" \
--repo owner/repo
```
## ラベル自動付与
Issue タイプに応じて自動的にラベルが付与されます:
| タイプ | ラベル |
|--------|--------|
| feature | 🆕feature, enhancement |
| bug | 🐛bug |
| refactor | ♻️refactor |
| docs | 📝documentation |
| performance | ⚡performance |
| security | 🔒security |
| test | 🧪test |
優先度に応じたラベル:
| 優先度 | ラベル |
|--------|--------|
| High | 🔴priority-high |
| Medium | 🟡priority-medium |
| Low | 🟢priority-low |
Agent自動実行:
| 設定 | ラベル |
|------|--------|
| 有効 | 🤖agent-execute |
## Issue Templateとの違い
### GitHub Issue Template (手動作成)
- GitHubのWebUI上で手動で作成
- テンプレートに沿って手動入力
- ラベルは手動で付与
### /create-issue コマンド (Claude Code)
- コマンドラインから対話的に作成
- 自動でテンプレート生成
- ラベル自動付与
- Agent実行設定をその場で決定
## バッチ作成
複数Issueを一度に作成する場合は、YAMLファイルから読み込み可能:
### issues.yaml
```yaml
issues:
- title: ユーザー認証機能
type: feature
requirements:
- ログイン画面
- JWT認証
priority: high
autoExecute: true
- title: プロフィール編集
type: feature
requirements:
- 編集画面UI
- 更新API
priority: medium
autoExecute: true
- title: パフォーマンス改善
type: performance
requirements:
- バンドルサイズ削減
- 遅延読み込み実装
priority: low
autoExecute: false
```
### バッチ実行
```bash
# Claude Code内で
/create-issue --batch issues.yaml
```
**期待される出力**:
```
🤖 Batch Issue Creator
issues.yaml を読み込み中...
3件のIssueを作成します
1/3: ユーザー認証機能
✅ Issue #125 作成
🤖 Agent実行開始
2/3: プロフィール編集
✅ Issue #126 作成
🤖 Agent実行開始
3/3: パフォーマンス改善
✅ Issue #127 作成
⏸️ 手動実行待ち
✅ バッチ作成完了
作成数: 3件
Agent自動実行: 2件
手動実行待ち: 1件
詳細: .ai/issues/batch-2025-10-08.json
```
## 設定
### .claude/settings.local.json
```json
{
"issueCreation": {
"defaultPriority": "medium",
"autoExecuteByDefault": true,
"defaultLabels": ["🤖agent-execute"],
"requireApproval": false,
"templates": {
"feature": ".github/ISSUE_TEMPLATE/feature.md",
"bug": ".github/ISSUE_TEMPLATE/bug.md"
}
}
}
```
## トラブルシューティング
### Q1: `gh` コマンドが見つからない
```bash
# GitHub CLI インストール
brew install gh # macOS
# または
npm install -g @github/cli
# 認証
gh auth login
```
### Q2: Issue作成権限エラー
```
Error: Resource not accessible by personal access token
対処法:
1. GitHub Token の権限確認
- repo スコープが必要
2. .env ファイルの GITHUB_TOKEN を確認
```
### Q3: Agent が自動実行されない
```
確認事項:
1. 🤖agent-execute ラベルが付与されているか確認
2. GitHub Actions Workflow が有効か確認
3. ANTHROPIC_API_KEY が Secrets に設定されているか確認
```
## 関連ドキュメント
- [.github/ISSUE_TEMPLATE/agent-task.md](../../.github/ISSUE_TEMPLATE/agent-task.md) - Issue Template
- [docs/AGENT_OPERATIONS_MANUAL.md](../../docs/AGENT_OPERATIONS_MANUAL.md) - Agent運用マニュアル
- [GitHub CLI Documentation](https://cli.github.com/manual/)
---
🤖 このコマンドは対話的にIssueを作成し、Agent実行を効率化します。