improve-prompt

プロンプトの改善

大まかなプロンプトを、プロジェクトのコンテキストを自動で調査したうえで、正確で構造化された AI コーディングプロンプトに変換します。

ワークフロー

以下の3つのフェーズを順番にすべて実行してください。フェーズを省略してはいけません。

フェーズ 1 — 意図の明確化

ユーザーの大まかな入力を解釈します。以下を特定してください。

• タスクの種類：リファクタリング／実装／デバッグ／機能追加／移行／レビュー／説明
• 主要な言語とフレームワーク（入力またはフェーズ 2 の調査から特定）
• 期待される出力形式：コードのみ／ファイルの変更／アーキテクチャ計画／説明

大まかなプロンプトからタスクの種類を判断できない場合は、妥当な推測を行い、生成するプロンプトの Task フィールドにその旨を記載してください。

フェーズ 2 — プロジェクトコンテキストの調査

改善したプロンプトを一語でも書き始める前に、現在のプロジェクトを調査してください。references/project-research-playbook.md の手順に従ってください。

最低限必要な調査（必ず実行）：

cat README.md 2>/dev/null | head -80
cat CLAUDE.md 2>/dev/null | head -60
cat AGENTS.md 2>/dev/null | head -60
cat .github/copilot-instructions.md 2>/dev/null | head -40
cat .cursorrules 2>/dev/null | head -40
cat package.json 2>/dev/null | head -40
find . -maxdepth 2 -type d | grep -v node_modules | grep -v .git | head -25
git log --oneline -8 2>/dev/null

タスクで特定のファイルやモジュールが参照されている場合は、追加調査を行い、grep と glob を使って該当箇所を探してください。

調査の詳細なガイダンス： references/project-research-playbook.md

フェーズ 3 — 改善したプロンプトの出力

フェーズ 1 で特定した意図とフェーズ 2 で得たコンテキストをもとに、references/ai-coding-prompt-guide.md に従って構造化されたプロンプトを生成してください。

必須の出力形式：

**Role:** [specific persona matching the project stack]
**Context:** [framework + key libraries + relevant file paths with exact paths]
**Task:** [one precise action-verb sentence]
**Constraints:** [what NOT to do, style rules, size limits]
**Output format:** [code only / with explanation / diff / step-by-step then code]
**Acceptance criteria:** [testable conditions — at least one]
**References:** [exact file paths from the research phase]

ユーザーが簡単にコピーできるよう、改善したプロンプトをフェンス付きコードブロックに入れて出力してください。

エージェント型のコンテキストで Claude を対象とする複雑なタスクでは、Markdown の見出しより XML 構造形式を優先してください。テンプレートについては references/ai-coding-prompt-guide.md を参照してください。

フィールドごとのガイダンスとアンチパターン： references/ai-coding-prompt-guide.md

例

ユーザーの入力（大まかな内容）： 「認証を修正して」

フェーズ 1： タスク = デバッグ／修正、プロジェクトに基づき TypeScript／Node.js と推定、出力 = コードの変更

フェーズ 2： 調査により、src/auth/middleware.ts、NestJS + Passport、直近の git コミットで JWT 検証エラーが確認される

フェーズ 3 の出力：

**Role:** Senior TypeScript engineer working on a NestJS REST API with Passport and JWT
**Context:** NestJS app, `src/auth/middleware.ts` handles JWT validation using jsonwebtoken v9. TypeScript strict mode enabled. ESM module.
**Task:** Fix the JWT token validation in `src/auth/middleware.ts` — tokens are not being rejected when expired
**Constraints:** Do not change the `AuthMiddleware` class public interface. No new dependencies. Keep existing error format.
**Output format:** Modified `src/auth/middleware.ts` only, with a brief comment on each change
**Acceptance criteria:** Expired tokens return 401 with `{ error: "TOKEN_EXPIRED" }`. Valid tokens still pass through.
**References:** `src/auth/middleware.ts`, `src/auth/auth.module.ts`