tomevault-io Create Issue
会話中に認識したタスクや改善点を GitHub Issue として作成するスキル。
トリガー条件
以下のような状況で積極的に Issue 作成を提案する:
- バグや問題を発見したとき
- 「後でやる」「TODO」などの言及があったとき
- リファクタリングの必要性を認識したとき
- 機能改善のアイデアが出たとき
- 技術的負債を発見したとき
- ドキュメントの不足を認識したとき
手順
Step 1: タスクの整理
会話から以下を抽出:
- ゴール: 何を達成したいか
- タイプ: feat / fix / refactor / docs / test / chore
- 背景: なぜこのタスクが必要か
- スコープ: 影響範囲（ファイル、コンポーネント等）
Step 2: Issue テンプレートに沿って作成
gh issue create \
--title "<type>: <簡潔なタイトル>" \
--body "$(cat <<'EOF'
## ゴール
<達成したいこと>
## タイプ
- [ ] feat (新機能)
- [ ] fix (バグ修正)
- [ ] refactor (リファクタリング)
- [ ] docs (ドキュメント)
- [ ] test (テスト)
- [ ] chore (メンテナンス)
## 背景・コンテキスト
<なぜこのタスクが必要か>
## スコープ
- 対象ファイル/コンポーネント:
- 影響範囲:
## 受け入れ条件
- [ ] 条件1
- [ ] 条件2
## 備考
<追加情報があれば>
EOF
)"
Step 3: ラベルの付与（オプション）
gh issue edit <number> --add-label "<label>"
利用可能なラベル例:
bug- バグ報告enhancement- 機能改善documentation- ドキュメントrefactor- リファクタリングpriority:high- 優先度高priority:low- 優先度低good first issue- 初心者向け
タイトルの規則
| タイプ | タイトル例 |
|---|---|
| feat | feat: ダークモードの追加 |
| fix | fix: ヘッダーのレイアウト崩れ |
| refactor | refactor: 認証ロジックの整理 |
| docs | docs: API ドキュメントの追加 |
| test | test: ArticleCard のテスト追加 |
| chore | chore: ESLint ルールの更新 |
会話からの Issue 作成例
例 1: バグ発見時
会話:
「記事ページでダークモード切り替えると、コードブロックの色が変わらない」
→ Issue 作成:
タイトル: fix: ダークモード時にコードブロックの色が変わらない
ゴール: ダークモード切り替え時にコードブロックも適切に色が変わること
タイプ: fix
例 2: TODO の認識
会話:
「このコンポーネント、後でテスト書いておきたい」
→ Issue 作成:
タイトル: test: ArticleCard コンポーネントのテスト追加
ゴール: ArticleCard のユニットテストを追加してカバレッジを向上
タイプ: test
例 3: リファクタリング提案
会話:
「この関数、複雑すぎるから分割した方がいいな」
→ Issue 作成:
タイトル: refactor: processArticle 関数の分割
ゴール: 可読性と保守性の向上のため関数を適切に分割
タイプ: refactor
クイックコマンド
# Issue 作成（シンプル）
gh issue create --title "タイトル" --body "説明"
# Issue 作成（ラベル付き）
gh issue create --title "タイトル" --body "説明" --label "bug"
# Issue 一覧確認
gh issue list
# 作成した Issue を確認
gh issue view <number>
# ラベル一覧
gh label list
ユーザーへの確認
Issue を作成する前に、以下を確認:
- タスクの内容が正しく理解できているか
- タイトルと説明が適切か
- 今すぐ作成するか、後で作成するか
以下の内容で Issue を作成しますか？
タイトル: <title>
タイプ: <type>
ゴール: <goal>
[はい / 内容を修正 / キャンセル]
注意事項
- 重複 Issue がないか事前に確認（
gh issue listで検索） - タイトルは具体的かつ簡潔に
- 受け入れ条件は明確に定義
- 関連する Issue があればリンク（
Related to #XX） - 作成後は Issue 番号をユーザーに伝える
Converted and distributed by TomeVault — claim your Tome and manage your conversions.