要件、設計ドキュメント、会話内容からGitHub Issueを作成する。ユーザーが計画ドキュメントからIssueを作成したい、要件をIssueに変換したい、タスクをIssueとして登録したい、または複数の関連するIssueをまとめて作成したい場合に使用。「この要件をIssueに登録」「plan.mdをIssueにして」「要件ごとにIssueを作って」などのリクエストでトリガーされる。
要件ドキュメント、会話、設計仕様から適切な構造のGitHub Issueを作成します。
以下の場合にこのSkillを使用:
要件がどこから来ているかを特定:
重要: 新しいIssueを作成する前に、必ずリポジトリの既存Issue形式を確認する。
# 既存Issueを取得して形式を理解
gh issue list --limit 3 --json number,title,body,labels --state all
分析項目:
詳細なフォーマットガイドは issue_template.md を参照。
複数の要件が含まれる場合:
論理的な境界を特定:
設計ドキュメントの場合:
会話コンテキストの場合:
各要件に対して、gh issue createを使用してIssueを作成:
gh issue create --title "タイトル" --body "$(cat <<'EOF'
[Issue本文の内容]
EOF
)"
タイトルのガイドライン:
本文の構造(リポジトリの形式に合わせて調整):
[目的の1〜2文の概要]
## 仕様
- [主要な仕様1]
- [主要な仕様2]
- [主要な仕様3]
## [要件タイプに応じたオプションセクション]
### 計算方法
[該当する場合の計算詳細]
### 出力例
[期待される出力の例]
### 判定基準
[該当する場合の判定基準]
## 関連
[plan.mdや他のドキュメントへの参照]
複数のIssueを作成する場合:
gh issue createコマンドを実行# すべてのIssueが作成されたことを確認
gh issue list --limit 5 --json number,title,state
作成したIssueの概要を提供:
✅ 4件のIssueを作成しました:
- #104: 週次/月次の記事公開数を集計する機能を追加
- #105: 平均公開間隔(日数)を計算する機能を追加
- #106: 最長無投稿期間を計算する機能を追加
- #107: 過去30日間の公開傾向を判定する機能を追加
ユーザー: "plan.mdの要件をIssueに登録して"
手順:
1. plan.mdを読んで要件セクションを特定
2. `gh issue list`で既存Issue形式を確認
3. 要件セクションごとに1つのIssueを作成
4. 各Issueの本文でplan.mdを参照
ユーザー: "今話した3つの機能をIssueにして"
手順:
1. 会話を振り返り、議論された3つの機能を抽出
2. 既存Issue形式を確認
3. 不明確な場合はユーザーに分割方法を確認
4. 会話のコンテキストを含めてIssueを作成
ユーザー: "この要件を実装用、テスト用、ドキュメント用の3つのIssueに分けて"
手順:
1. ベースとなる要件を理解
2. 適切なスコープで3つのIssueを作成:
- 実装Issue
- テストIssue
- ドキュメントIssue
3. Issueの本文で相互参照
Issue作成が失敗する:
gh CLIが認証されているか確認形式が間違っている:
gh issue view <number>で既存Issueを再確認Issueの数が多すぎる/少なすぎる: