🐛 Issue 指示書生成
バグ報告・Issue情報をもとに、AI駆動バグ修正用の詳細指示書を生成します。 ファイル出力先・使用AIツール・トークン予算管理に対応。
パラメータ
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
issue_title | str | ✅ | 課題タイトル |
issue_description | str | ✅ | 課題内容・再現手順・証跡(エラーコード, ログ, スクリーンショット説明) |
target_module | str | - | 対象モジュール・コンポーネント名(省略時は AI が推定) |
issue_id | str | - | 課題ID(例: BUG-001)。デフォルト: ISSUE-XXX |
priority | str | - | 優先度(高 / 中 / 低)。デフォルト: 中 |
dev_tool | str | - | 使用するAIツール名(Cursor / Claude Code / GitHub Copilot)。デフォルト: Claude Code |
output_dir | str | - | 指示書の出力先ディレクトリ。デフォルト: docs/bug-fixes |
使用例
issue_title: ログイン画面でパスワードリセットリンクが届かない
issue_description: |
- エラーコード: メール送信エラー 500
- 発生条件: ユーザーが「パスワードを忘れた」→メールアドレス入力→送信
- ログ: [2026-02-19] SMTP connection timeout to mail.example.com:587
target_module: auth/password-reset
issue_id: BUG-001
priority: 高
dev_tool: Cursor
output_dir: docs/bug-fixes出力内容
以下を含む構造化された指示書(Markdown)を生成します:
- DRAFT 注記 — 自動生成ドラフトである旨の注意書き
- メタデータテーブル — 課題ID・優先度・コンポーネント・推定難易度・担当者・トークン予算
- 1. 事象の説明 — 現象・影響範囲・再現手順・再現証跡(エラーコード・ログ・入力条件・実行環境)
- 2. 前提知識・アーキテクチャ — バグに直接関連する箇所のみ
- 3. 関連ファイル・コード箇所 — ファイル・行番号・説明のテーブル
- 4. 受け入れ条件と検証手順 — チェックリスト+検証手順
- 5. 制約・注意事項 — ドキュメント上書き禁止ルール等
- 6. AIへの最初のプロンプト —
dev_toolに応じた操作手順と調査プロンプト - 7. 完了定義(DoD) — 再現確認・実装・テスト・設計書更新・トークン記録・レビューのチェックリスト
dev_tool 別のプロンプト冒頭
| dev_tool | 操作方法 |
|---|---|
Cursor | @ファイルパス 形式で関連ファイルを参照してから実行 |
Claude Code | claude コマンドで起動し入力 |
GitHub Copilot | VS Code のチャット欄(Ctrl + I)に貼り付け |
| その他 | ツールの操作方法に従い実行 |
出力ファイル名
{output_dir}/{issue_id}-{issue_title}.md例: docs/bug-fixes/BUG-001-ログイン画面でパスワードリセットリンクが届かない.md
ワークフロー上の位置づけ
課題認識 → 再現確認 → [issue_instruction_generator] → レビュー → 実装 → テスト → 完了このプロンプトは 指示書生成(AI) ステップを担います。 生成された指示書をレビューし、技術妥当性・再現性を確認してから実装に渡します。
関連情報
このページは手動作成されています ソースコード: src/prompts/project.ts