【要約】AIへの頼み方を4パターンで比べたら、説明文の量が137字→0字まで変わった [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者がClaude Code等のCLIツールを業務で利用する際、指示の書き方によって返答の長さや丁寧さが変動する問題に直面する。この挙動の不安定さは、情報の即時取得や自動化処理の妨げとなる。具体的には以下の課題が挙げられる。
- ・指示内容が同じでも、返答の構成が予測できない。
- ・不要な説明文が混入し、必要なコードの抽出を阻害する。
- ・役割指定が、意図せず冗長な出力を招く可能性がある。
// Approach
筆者がClaude Codeのコマンドラインモードを用い、同一のタスクに対して4種類のプロンプトを適用して比較検証を行った。検証には以下の手法を用いた。
- ・タスク設定：「回文判定するPython関数を書く」という同一の依頼。
- ・パターンA：指示のみの素の状態。
- ・パターンB：シニアエンジニアとしての役割指定。
- ・パターンC：入出力例を提示するFew-shot。
- ・パターンD：出力形式（コードブロックのみ）の厳格な指定。
- ・計測手法：
claude -pに--output-format jsonを付与し、文字数やコードブロック数を機械的に集計。
// Result
検証の結果、プロンプトの構成次第でAIの応答形式を劇的に制御できることが判明した。具体的な成果は以下の通りである。
- ・出力形式の明示（パターンD）により、説明文を0文字に抑制できた。
- ・Few-shot（パターンC）の導入により、明示的な指示なしでも説明文を4文字まで削減できた。
- ・役割指定（パターンB）は、逆に説明文を179字、総文字数を719字まで増加させた。
Senior Engineer Insight
> プロンプト制御は、単なる利便性の問題ではなく、システム統合における「インターフェースの安定性」の問題である。特に、AIの出力を後続のプログラムでパースする場合、パターンDのような厳格な出力指定は、パースエラー防止とトークンコスト削減の観点から必須となる。一方で、役割指定が冗長性を招く点は、レイテンシとコストの管理において注意すべき挙動である。実運用では、出力の「型」をいかに固定するかが、スケーラブルなAI活用への鍵となる。