Agent skill
consultation
実装中に判断が必要になった時、技術選定・設計相談が必要な時に使用。相談テンプレートで構造化された問題提示を強制。
Install this agent skill to your Project
npx add-skill https://github.com/TakumiOkayasu/dotfile-work/tree/main/claude/skills/consultation
SKILL.md
Consultation
トリガー条件
以下のいずれかに該当する場合、このスキルを発動する:
- 仕様が曖昧で判断できない(掘り下げても不明)
- 技術選定が必要(複数案を比較検討済み)
- 設計の大きな変更が必要(影響範囲を整理済み)
- パフォーマンス・セキュリティ上の懸念(具体的な数値・リスクあり)
- 予想外の問題に遭遇(根本原因の仮説あり)
- 同じ問題で3回以上失敗した
発動しない場合: 公式ドキュメントで解決できる / まだ何も試していない / エラーメッセージ未確認
前提条件
相談を開始する前に以下をすべて満たすこと:
- 問題を「AとBで迷っている」レベルまで絞り込んだ
- 少なくとも1つ以上の解決策を試した
- エラーメッセージ・ログを記録した
- 公式ドキュメントを確認した
手順
Phase 1: 問題の言語化
- 現在のタスクとブランチを確認する
- 「何が起きているか」を事実ベースで整理する
- 期待値と実際の差異を明確にする
- 「なぜ?」を3〜5回繰り返して根本原因を探る
Phase 2: 相談内容の構造化
下記テンプレートをすべて埋める:
【相談: {一行サマリ}】
## 1. 何が起きているか (事実)
- 現在のタスク / 進捗 / ブランチ / 現象
## 2. なぜそれが問題なのか
- 期待 vs 実際 / このままだと何が困るか
## 3. なぜその問題が発生したのか
- 「なぜ?」を3-5回繰り返して根本原因を探る
## 4. 何を試したか
1. 試したこと → 結果 → なぜダメだったか
2. ...
## 5. 判断が必要な点 (具体的に)
- AとBのどちらを使うべきか?
## 6. 制約条件
- パフォーマンス / 互換性 / セキュリティ
Phase 3: 相談の送信
- テンプレートが全項目埋まっていることを確認する
- スマホ・PCクライアントへ送信する
- 回答を受け取るまでコーディングを停止する
Phase 4: 回答の反映
- 方針が決定したらブランチ・タスクに戻る
- 決定内容をコード・コメント・PROGRESS.mdに記録する
役割分担
| ClaudeCode (ここ) | スマホ・PCクライアント |
|---|---|
| コーディング・ファイル操作 | 問題の整理・分析 |
| テスト実行・デバッグ | 解決方針・アーキテクチャ設計 |
出力形式
相談送信時は必ずテンプレートの全セクションを含めること。省略不可。
良い例:
✅ 「JWTの保存場所、localStorageとhttpOnly Cookieで迷っている。XSS vs CSRF のトレードオフ」
悪い例:
❌ 「認証がうまくいかない。どうすればいい?」
禁止事項
- 「何が分からないか分からない」状態で相談
- 何も試さずに相談
- 公式ドキュメントを確認せずに相談
- 漠然とした質問(「どうすればいい?」)
- エラーメッセージを記録せずに相談
- テンプレートを部分的にしか埋めずに相談
- 回答待ち中に別の実装を進める
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
performance-optimization
パフォーマンス最適化やプロファイリング時に使用。計測手法、ボトルネック特定、負荷テスト、レポート出力をカバー。
systematic-debugging
バグやテスト失敗に遭遇した際に使用。修正前の4フェーズ根本原因分析を強制。
interface-first-design
機能追加・クラス設計・interface設計・依存関係整理・責務分割時に使用。疑似コードから interface→クラス→TDD→実装の順で設計する。TDDスキルの前段。
test-coverage-guard
既存テストの信頼性を検証し、偽陽性を検出・排除するガードレール。テストがGREENになった後に発動する。
refactoring
振る舞いを変えずにコード構造を改善する際に使用。
e2e-browser
ブラウザE2Eテスト生成・実行・レポート(Docker内Playwright+Bun+Knex.js)。UI操作+DB検証+全ステップスクショ。WSLg/noVNC/headless切替対応。プロジェクト非汚染。
Didn't find tool you were looking for?