메뉴
開発環境の問題を症状に応じて適切な専門診断スキルに振り分けるか、直接診断を行う。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
@issue_note.txt の課題No、または Evernote 共有リンク（ノート下書き）をもとに、GitHub Issueを作成する。対応種別に応じてfeature/bugfixテンプレートを使い分ける。
PRをMerge commit方式でマージし、リモート・ローカル両方のfeatureブランチを削除して司令塔ベースブランチを最新化する。マージのタイミングはユーザーが決める。
Issue起点の実装計画を作成する。Issueの内容とプロジェクトの設計ドキュメントを照合し、影響範囲・実装方針・テスト方針を含む計画を出力する。
Playwright MCPを使って、既に起動済みのlocalhost環境に対してE2E観点の動作確認を行うための運用ルール。
PRのコードレビューを実施し、レビュー結果をPRコメントとして投稿する。アーキテクチャ観点でのコードレビュー。
ブランチ・Git運用ルール。feature ブランチ作成、コミット、プッシュ、PR作成の手順。品質チェック後のGit操作フロー。
| name | dev-doctor |
| description | 開発環境の問題を症状に応じて適切な専門診断スキルに振り分けるか、直接診断を行う。 |
| when_to_use | 「dev-doctor」「環境が壊れた」「サービスがぶっ壊れた」「動かない」「エラーが出る」などの発言時で、具体的な症状が不明な場合 |
| context | fork |
| agent | dev-doctor |
引数: $ARGUMENTS（症状の説明。省略時はヒアリングを行う）
ユーザーの発言から症状カテゴリを推定できない場合、以下の2軸で質問する:
1. 何をしようとしましたか？
2. 何が起きましたか？（エラーメッセージ、具体的な症状）
| 症状カテゴリ | 案内先 |
|---|---|
| devサーバー起動後にページが開けない / ポートエラー | /access-problem を使ってください |
| ページは開けるがコンパイルが遅い・HMRが効かない | /compile-problem を使ってください |
| gitコマンドが重い・結果が返ってこない | /git-problem を使ってください |
| ビルドが通らない・TypeScript型エラー | 直接診断を実行（下記フォールバック参照） |
| pnpm installが失敗する・依存関係エラー | 直接診断を実行（下記フォールバック参照） |
| マイグレーション失敗・スキーマ不整合 | 直接診断を実行（下記フォールバック参照） |
| テストが落ちる・テスト環境が壊れた | 直接診断を実行（下記フォールバック参照） |
| Vercelデプロイ失敗・プレビュー壊れた | 直接診断を実行（下記フォールバック参照） |
| ログインできない・セッション問題 | 直接診断を実行（下記フォールバック参照） |
問題が複数カテゴリにまたがる場合、以下の順で基盤的な問題から解決する:
専門スキルが存在しないカテゴリの場合、dev-doctorエージェント本体の「汎用診断フレームワーク」に従って直接診断を行う。ユーザーに「スキルが未作成です」等のメッセージは表示せず、シームレスに対応すること。
汎用診断フレームワーク:
pnpm dev / pnpm dev:web / pnpm dev:admin / npm run dev の実行（ユーザーが起動する）run_in_background: true の使用supabase init の実行