79yuuki/dotfiles/prompt-design

Prompt Design — エージェント向けプロンプト設計スキル

Claude公式ベストプラクティスをチェックリストとパターン集に凝縮。 特定モデルの癖ではなく、モデルが変わっても効く原則として書く。

Source: https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/

📋 チェックリスト

必須（全プロンプト共通）

• [ ] 明確で具体的か？ — 「いい感じに」ではなく具体的な指示
• [ ] なぜそうするか（動機）を書いたか？ — Claudeは動機から一般化できる
• [ ] 例は最小限か？ — 例は探索の幅を狭める。使い方は引数・enum・スクリプトのインターフェースで示し、例を置くなら促進したい動作だけ
• [ ] 「何をするか」で書いたか？ — 否定形より肯定形
• [ ] アクション指示は明示的か？ — 「提案してもらえますか」→「実装してください」

エージェント/長時間タスク向け

• [ ] コンテキスト継続指示があるか？ — 圧縮環境での早期停止防止
• [ ] 状態管理の指示があるか？ — JSON + テキストメモ + git追跡
• [ ] 検証手段を提供したか？ — テスト、Playwright、チェックコマンド
• [ ] インクリメンタル進捗指示があるか？ — 少しずつ着実に
• [ ] 長セッションのGoalアンカーがあるか？ — 冒頭で「今回の最終状態」を1–3行で固定し、ドリフト時に戻れる北極星を置く

安全性・自律性

• [ ] 破壊的アクションの確認指示？ — force push・削除・外部送信の前に確認させる
• [ ] サブエージェント使用ガイドライン？ — 独立した並列作業や広い探索の時だけ使い、数手で済む作業は自分で行う

剪定（モデル更新時に見直す）

• [ ] 過激な言語を控えめに？ — ×「CRITICAL: MUST」→ ○「Use when...」
• [ ] 思考を促す文言を残していないか？ — 「think step by step」「よく考えて」は書かない。考える量は effort で調整する
• [ ] 同じ指示を2か所に書いていないか？ — CLAUDE.md と skill・ツール説明で重複させず、1か所に置いて他は pointer にする
• [ ] 特定モデル向けの回避策が残っていないか？ — 旧モデルの癖への対処は、新モデルで外して評価し直す

🧱 パターン集

→ 詳細: references/patterns.md

📦 Progressive Disclosure最適化

SKILL.md構造の最適化パターン（トークン40-45%削減）。 → 詳細: references/progressive-disclosure.md

🔧 使い方

📚 元ソース

• https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/claude-prompting-best-practices
• 最終同期: 2026-03-04

振り返り

• 初回作成: 2026-03-04
• 2026-03-16: Progressive Disclosure適用。本体255→90行。パターン集・詳細をreferences/に分離
• 2026-11-04: 旧モデルの名指しをモデル非依存の原則に書き換え、剪定の観点（思考の文言・重複・回避策）と例の最小化を追加（claude.dev blog）