Skip to content

🐛 Issue 指示書生成

バグ報告・Issue情報をもとに、AI駆動バグ修正用の詳細指示書を生成します。 ファイル出力先・使用AIツール・トークン予算管理に対応。

パラメータ

パラメータ名必須説明
issue_titlestr課題タイトル
issue_descriptionstr課題内容・再現手順・証跡(エラーコード, ログ, スクリーンショット説明)
target_modulestr-対象モジュール・コンポーネント名(省略時は AI が推定)
issue_idstr-課題ID(例: BUG-001)。デフォルト: ISSUE-XXX
prioritystr-優先度( / / )。デフォルト:
dev_toolstr-使用するAIツール名(Cursor / Claude Code / GitHub Copilot)。デフォルト: Claude Code
output_dirstr-指示書の出力先ディレクトリ。デフォルト: 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 Codeclaude コマンドで起動し入力
GitHub CopilotVS Code のチャット欄(Ctrl + I)に貼り付け
その他ツールの操作方法に従い実行

出力ファイル名

{output_dir}/{issue_id}-{issue_title}.md

例: docs/bug-fixes/BUG-001-ログイン画面でパスワードリセットリンクが届かない.md

ワークフロー上の位置づけ

課題認識 → 再現確認 → [issue_instruction_generator] → レビュー → 実装 → テスト → 完了

このプロンプトは 指示書生成(AI) ステップを担います。 生成された指示書をレビューし、技術妥当性・再現性を確認してから実装に渡します。

関連情報


このページは手動作成されています ソースコード: src/prompts/project.ts

MIT License