issue
GitHub Issue の起票を自動化。タイトル・本文からラベルを自動判定し、Assignees を設定して起票する。「/issue」「Issue作成」と言った時に使用。
SKILL.mdskills/issue/SKILL.md
GitHub🎫 Issue 起票自動化
[!IMPORTANT] このスキルは CEO から Issue 内容を 1 ターンでバッチヒアリングし、intent ラベル + CC prefix + 3 者承認ゲートを通して起票する。 判定の主従順は intent → CC prefix(逆引き禁止、
docs/conventional-commits.mdの絶対条件)。1 Issue 1 intent 厳守。 3 者承認ゲート(CISO + CPO + SM)はstandard以上で有効。minimalは 3 者ゲートなしで起票(minimal プリセットの安全性は別経路で担保)。 結果のみを簡潔に返す。途中経過は出力しない。
ユーザーから Issue 内容をヒアリングし、ラベル自動判定 + Assignees 設定で起票する。結果のみを簡潔に返すこと。途中経過は不要。
📝 本文の書き方
Issue タイトル・本文は CEO が読むため .claude/rules/communication.md に従って動作主語で書く(「〜になった/〜できるようになった」)。関数名・ファイルパスを並べるのではなく、ソフトウェアのふるまいの変化を 30 秒で掴める形にする。
関連 Issue / PR への参照
Issue 本文から他の Issue / PR を参照する場合は Refs #N 形式で書く。Closes #N は使わない(Issue 本文は GitHub の auto-close を発火させないが、PR 本文との表記揺れを避けるため Refs に統一する)。
| 関係 | 書式 |
|---|---|
| 親エピック Issue を参照 | Refs #<親エピック番号> |
| 関連 Issue / 過去 PR を参照 | Refs #N |
PR 本文での Closes #N / Refs #N 運用は .claude/rules/workflow.md「PR 本文の Issue リンク(auto-close キーワード)」を参照する。
使用方法
/vibecorp:issue # CEO に 1 ターンでバッチヒアリングして起票
ヒアリング項目は タイトル / 本文 / 完了条件 / 関連ファイル の 4 項目(ステップ 2 参照)。CEO が一度に全項目を提供した場合はそのまま使用する。
ワークフロー
1. 🔍 リポジトリ情報の取得
gh repo view --json owner,name,defaultBranchRef --jq '.owner.login + "/" + .name'
リポジトリオーナーを Assignees のデフォルトに使用する。
gh repo view --json owner --jq '.owner.login'
2. 💬 ユーザーから Issue 内容を取得(1 ターンバッチ質問)
以下の 4 項目を 1 ターンでバッチ質問する。複数ターンに分けない(公式の Reduce the number of required user interactions 原則)。CEO はまとめて入力するため、項目が増えてもターン数は増えない。
- タイトル: Issue の内容(タイプは自動付与するため不要)
- 本文: Issue の詳細(Markdown 形式、💡概要 / 🎯背景 / 📝提案 等を含む)
- 完了条件: 検証可能なチェックリスト(acceptance criteria)。本文には
## ✅ 完了条件セクションとして含める - 関連ファイル: 触れるファイル・モジュールのパス一覧(relevant file locations)。本文には
## 📍 関連ファイルセクションとして含める
ユーザーが一度に全項目を提供した場合はそのまま使用する。完了条件・関連ファイルが提供されない場合は、再度の対話を 1 ターン追加するのではなく、最初の 1 ターン内で 4 項目をまとめて要求する文面にする。
設計根拠(Anthropic 公式 Best practices)
Best practices for using Claude Opus 4.7 with Claude Code の Structuring interactive coding sessions セクションに基づく。
Specify the task up front: 初回プロンプトにintent / constraints / acceptance criteria / relevant file locationsの 4 要素を含めるReduce the number of required user interactions: 質問はバッチ化する(every user turn adds reasoning overhead)
vibecorp での 4 要素の肩代わり状況:
| 要素 | 肩代わり手段 |
|---|---|
intent |
本文(💡概要 / 🎯背景)に CEO が記述 |
constraints |
.claude/rules/ 一式が CLAUDE.md 経由で常駐(ヒアリング不要) |
acceptance criteria |
本文の ## ✅ 完了条件 セクション |
relevant file locations |
本文の ## 📍 関連ファイル セクション |
constraints は常駐ルールで自動補完されるため、CEO に追加で質問しない。残る 3 要素(intent / acceptance criteria / relevant file locations)を 1 ターンでバッチ質問する。
3. 🧭 SM 自動判定(エピック/単発ルーティング)
full プリセットの場合のみ、SM エージェント(.claude/agents/sm.md)を 1 回だけ 呼び、Issue の内容を「単発」か「エピック化」かに自動判定する。合議は行わず SM 1 人で判定する(CEO 判断: コスト抑制と意思決定の単純化のため)。
適用条件
vibecorp.yml が存在する場合のみ preset を確認する。
if [ -f "$CLAUDE_PROJECT_DIR/.claude/vibecorp.yml" ]; then
awk '/^preset:/ { print $2 }' "$CLAUDE_PROJECT_DIR/.claude/vibecorp.yml"
fi
- preset が
fullの場合のみ SM 自動判定を実行する - preset が
minimal/standard、vibecorp.yml が存在しない、または preset キーが未定義の場合 → このステップを スキップ し、ステップ 4 以降の従来挙動(単発起票)に進む /vibecorp:plan-epicスキルが配置されていない場合 → このステップをスキップし、単発起票にフォールバックする
判定基準
SM エージェントは以下の観点で「単発判定 / エピック化判定」を行う。
- 複数要件の列挙: 本文が複数の独立した要件を列挙しているか(箇条書き・番号付きリストで 3 件以上の独立タスクが存在する)
- ファイル領域の複数跨ぎ: 影響範囲が複数のディレクトリ・モジュールに跨るか(例: hooks + skills + agents の同時変更)
- 並列実行可否: 各要件が独立して並列実装可能か(同一ファイル競合がない / 直列依存がない)
3 観点のうち 2 つ以上が当てはまればエピック化候補、それ以外は単発と判定する。
SM への依頼テンプレート
プロンプトは skills/issue/prompts/agent-call-sm-epic-judgment.md を参照する。
CEO override
ユーザー入力(タイトル・本文・補足指示)に以下の明示指示が含まれる場合、SM 判定を上書きする。
- 単発に上書き: 「単発でいい」「単発で起票」「単発で OK」等
- エピックに上書き: 「エピックにして」「エピック化して」「エピックで起票」等
override が適用された場合、返却時に「CEO override: あり」を明記する(透明性確保)。
判定結果の扱い
- 単発判定 → ステップ 4 以降に進む(従来通りタイプ判定 → 3 者承認ゲート → 起票)
- エピック化判定 →
/vibecorp:plan-epicスキルにタイトル・本文をそのまま渡してルーティングし、/issueの処理は終了する/vibecorp:plan-epicの出力(親 Issue URL + 子 Issue URL 一覧)をそのまま CEO に返す- エピック化判定時は本スキルのステップ 4 以降(タイプ判定・3 者承認ゲート・起票)は実行しない(
/plan-epic側で必要なゲートが実装される前提)
4. 🏷️ intent ラベル判定 + CC prefix 選択(COO 主体・FIX)
4a. COO による intent 判定
旧 type 14 種のキーワード判定表は 廃止(Issue #469 議論結論)。COO(メインセッション)が Issue 本文を読んで文脈で intent ラベルを判定する。
判定対象は .claude/rules/intent-labels.md の 7 種:
intent/feature— 新機能を確実に動かす(影響を与える系)intent/bugfix— 既存バグを最小修正で直す(影響を与える系)intent/performance— 性能を測定可能な形で改善する(影響を与える系)intent/security— 脆弱性を塞ぐ(影響を与える系)intent/refactor— 構造の品質を高める(挙動不変系)intent/infra— 開発基盤の品質を底上げする(挙動不変系)intent/docs— ドキュメントの正確性を担保する(挙動不変系)
絶対条件: 1 Issue 1 intent 厳守。複数 intent にまたがる変更は Issue を分割するよう CEO に提案する。
4b. COO による CC prefix 選択
intent → prefix の主従順で対応 prefix を選ぶ(逆引き禁止、docs/conventional-commits.md の絶対条件)。
| intent ラベル | 対応する CC prefix |
|---|---|
intent/feature |
feat |
intent/bugfix |
fix, revert(差し戻しは regression 修正の一形態) |
intent/performance |
perf, feat(性能向上目的の機能), fix(パフォーマンス系バグ) |
intent/security |
fix(脆弱性修正), feat(セキュリティ機能追加), chore(依存パッケージのセキュリティアップデート) |
intent/refactor |
refactor, style |
intent/infra |
test, ci, chore, build |
intent/docs |
docs |
同じ intent に対応する prefix が複数ある場合は、内容に応じて最も適切なものを COO が選ぶ。
4c. CC prefix → 絵文字 1:1 マッピング
docs/conventional-commits.md 確定の絵文字 11 種:
| CC prefix | 絵文字 |
|---|---|
| feat | ✨ |
| fix | 🐛 |
| perf | ⚡ |
| refactor | 🔄 |
| style | 💄 |
| docs | 📖 |
| test | 🧪 |
| ci | 🔧 |
| chore | ⚙️ |
| build | 📦 |
| revert | ⏪ |
タイトル形式: <emoji> <CC prefix>: <動作主語の subject>
- COO が intent → prefix → 絵文字の順で確定する(逆順禁止)
- 既存ラベル(
bug/enhancement等)はリポジトリに存在する場合のみ付与する - ユーザーが既にタイプ付きタイトルを入力していても、判定は 常に本文から intent を先に確定する(intent → prefix の主従順、絶対条件)。本文から確定した intent と既存タイトルの prefix が整合しない場合は、本文を優先して prefix と絵文字をタイトル側で修正する
- 既存ラベル一覧は
gh label list --json name --jq '.[].name' --limit 100で取得する
5. 👤 Assignees 決定
.claude/vibecorp.ymlにissue.default_assigneeが定義されていればその値を使用する- 未定義の場合はリポジトリオーナー(手順 1 で取得)を使用する
6. 🛡️ 3者承認ゲート(standard 以上)
vibecorp.yml が存在する場合のみ preset を確認する。
if [ -f "$CLAUDE_PROJECT_DIR/.claude/vibecorp.yml" ]; then
awk '/^preset:/ { print $2 }' "$CLAUDE_PROJECT_DIR/.claude/vibecorp.yml"
fi
preset が standard または full の場合のみ、CISO + CPO + SM の 3 者で .claude/rules/autonomous-restrictions.md に定義された自律実行不可領域(認証 / 暗号 / 課金構造 / ガードレール / MVV / CI エージェント)と、プロダクト方針の整合性を判定する。いずれかのエージェントが「除外」判定した場合は起票を中止する。
責務分離の根拠: /vibecorp:autopilot / /vibecorp:ship-parallel の自律ループが全 open Issue を対象とするため、不可領域の門番は起票側(本スキルと /vibecorp:diagnose)に集約する。ship 側は起票済み Issue を信頼して実行する。
6a. CISO フィルタリング(不可領域チェック)
CISO エージェント(.claude/agents/ciso.md)に依頼する。プロンプトは skills/issue/prompts/agent-call-ciso-issue-check.md を参照する。
6b. CPO フィルタリング(MVV / docs 整合 + 4 要素チェック)
CPO エージェント(.claude/agents/cpo.md)に依頼する。プロンプトは skills/issue/prompts/agent-call-cpo-issue-check.md を参照する。
4 要素チェックの位置づけ: Anthropic 公式が「初回プロンプトに含めろ」と明記している 4 要素のうち、constraints は .claude/rules/ 常駐で自動補完されるため Issue 本文には不要。intent / constraints / acceptance criteria / relevant file locations が揃っていない Issue は後段の /vibecorp:plan-review-loop が空欄を前提に走り品質が落ちるため、起票時点で書き忘れを検出して除外する。
6c. SM フィルタリング(自律実行可否チェック)
SM エージェント(.claude/agents/sm.md)に依頼する。プロンプトは skills/issue/prompts/agent-call-sm-issue-check.md を参照する。
判定結果の扱い
- 3 者全員が「OK」→ ステップ 7(起票)へ進む
- いずれかが「除外」→ 起票を中止し、却下フォーマット(後述)で報告して終了する
- preset が
minimal、vibecorp.yml が存在しない場合、または preset キーが未定義の場合 → このステップを全てスキップ(3 者フィルタなし)
minimal プリセットの安全性: minimal では 3 者フィルタが動作しないが、/vibecorp:autopilot / /vibecorp:ship-parallel が full プリセット専用のため、不可領域 Issue が自動実装される経路は存在しない。CEO が明示的に /vibecorp:ship を呼ぶ手動実装のみ可能で、これは CEO の意思による承認ルートとして許容される。
7. 🚀 Issue 起票
gh issue create --title "<emoji> <CC prefix>: <subject>" --body "<本文>" --assignee "<assignee>" --label "intent/<intent>" --label "<additional_label_if_any>"
intent/*ラベルは必須(COO が ステップ 4a で確定したもの 1 つだけ)- 既存ラベル(
bug/enhancement等)はリポジトリに存在し、内容に該当する場合のみ追加付与する - ラベルが intent のみの場合は
--label "intent/<intent>"のみ指定する
8. ✅ 結果報告
起票した Issue の URL を返す。full プリセットで SM 自動判定が動作した場合は判定結果も併記する。
制約
- jq では string interpolation
\(...)を使わない — Bash 上で\がエスケープ文字、()がサブシェルとして解釈され、意図しない展開やパースエラーを引き起こすため。必ず+で結合する - コマンドをそのまま実行する —
2>/dev/null、|| echo、; echo等のリダイレクトやフォールバックを付加しない(根拠) - リポジトリに存在しないラベルは
--labelに渡さない(gh issue createがエラーになるため) vibecorp.ymlが存在しない、またはissue.default_assigneeが未定義でも正常に動作すること
📤 返却フォーマット
通過時(単発起票)
<Issue URL>
タイトル: <emoji> <type>: <subject>
ラベル: <付与したラベル一覧(なしの場合は「なし」)>
担当者: <assignee>
full プリセットで SM 自動判定が動作した場合は、上記の末尾に判定結果を追記する。
### 判定結果(full プリセットのみ)
- SM 判定: 単発
- 判定根拠: <SM が判定の根拠とした要素を 1〜2 行で>
- CEO override: あり / なし
通過時(エピック化ルーティング)
full プリセットでエピック化と判定された場合は、/vibecorp:plan-epic の出力に判定結果を併記して返す。
✨ エピック化して起票しました
親 Issue: <親 Issue URL>
子 Issue:
- <子 Issue URL #1>
- <子 Issue URL #2>
...
### 判定結果
- SM 判定: エピック化
- 判定根拠: <SM が判定の根拠とした要素>
- CEO override: あり / なし
却下時(3 者承認ゲート)
❌ 起票を見送りました
### 判定結果
- CISO: {OK / 除外(理由)}
- CPO: {OK / 除外(理由)}
- SM: {OK / 除外(該当領域: 認証 / 暗号 / 課金構造 / ガードレール / MVV / CI エージェント のいずれか)}
### 却下理由
<除外と判定したエージェントの理由を要約>
### 対処方針
- 不可領域に該当する場合: MVV に立ち返って Issue の目的を再検討するか、CEO による手動承認・実装を検討してください
- MVV 不整合の場合: MVV.md に照らし合わせて Issue タイトル・本文を修正してください
🔗 関連ルール
- intent ラベル定義:
.claude/rules/intent-labels.md - CC prefix 厳格定義:
docs/conventional-commits.md - 不可領域定義:
.claude/rules/autonomous-restrictions.md - CEO 報告向け文面規約:
.claude/rules/communication.md - ブランチ命名・PR 本文の Issue リンク:
.claude/rules/workflow.md - エピック起票:
/vibecorp:plan-epic - プロンプト作成基準:
.claude/rules/prompt-writing.md - マークダウン規約:
.claude/rules/markdown.md