ほとんどのClaudeパイプラインの失敗はモデルではなくプロンプトに原因がある理由とスキルで修正する方法

最近のr/ClaudeAIの投稿が、よくあるパターンを指摘しています。プロンプトは単独では機能するが、パイプラインに配置すると、数週間後に静かに誤った出力を生成するというものです。根本原因はモデルではなく、プロンプトが文書化されていない入力形式を前提とし、呼び出し側だけが解析方法を知っている構造を返していたことにあります。投稿では、生のプロンプトとは対照的にスキルが、この種の障害を防ぐ3つの要素を強制すると論じています。

入力契約

プロンプトが必要とするフィールド、フィールドが欠けている場合の対処、最小限の入力が何かを正確に定義します。投稿によれば、これを書くのに10分かかり、午前2時に発生するような障害を防げます。

出力スキーマ

失敗状態を含め、戻り値の形式を正確に指定します。投稿からの例：

success = {action: string, confidence: float, reasoning: string}
failure = {action: "skip", reason: string}

「要約を返す」はスキーマではありません。スキーマにより、成功と失敗の両方が後続のノードで可視化されます。

学習ファイル

スキルが失敗したこと、発見されたエッジケース、本番で壊れたことを記録するファイルを保持します。これは時間とともに蓄積され、スキルで問題が発生するたびに、その痛みが次に実行する人によって再発見されるのではなく、そこに記録されます。

投稿者は要約しています：「プロンプト単体はv0です。スキルはv1に昇格させるものです。」