Anthropic、/claude-apiスキルとプロンプトアンチパターンガイドを公開
Anthropicは、Claude Codeに組み込まれたオープンソースの/claude-apiスキルを発表した。このスキルは、エージェントやClaude API開発におけるAPI呼び出しを最適化する。Claude Codeユーザーには不要であり、非Claudeモデルでは効果が低減する可能性がある。GitHub上でコードが公開されており、プロジェクトがAnthropic SDKをインポートするか、ユーザーが/claude-apiと入力すると起動する。Python、TypeScript、Java、Go、Ruby、C#、PHP、cURLのAPIドキュメントを読み込み、Messages APIとManaged Agentsを対象とする。cost-optimize機能は実際のAPI使用状況を分析し優先順位付きの節約案を提示する。prompt-auditはプロンプトやスキルをスキャンし、時代遅れや問題のあるパターンを検出する。migrateはAPIコードを新しいモデルに移行し、破壊的変更に対応する。managed-agents-onboardはManaged Agentの対話型セットアップを提供する。背景として、Fable 5.1ではプロンプトキャッシング価格が75%低下し、低い努力レベルでも従来の高い努力レベルに匹敵する。アンチパターンには、検証儀礼、徹底性・強調ブースター、必須手順・スクラッチパッドの足場、古いFew-shot例、矛盾するルール、時代遅れの設定が含まれる。これらのアンチパターンは蓄積され、モデルアップグレード時に悪影響を及ぼす。Opus 4.8からOpus 5への移行例では、検証儀礼が繰り返し作業を引き起こし、強調ブースターが数十回の不要なシステム検索を誘発した。プロンプト監査はパフォーマンスを向上させ、コストを削減する。執筆ガイダンスとして、気取った文体を排除し、比喩や飾り言葉ではなく、文字通りの表現を使用するよう求めている。
Key insights
/claude-apiスキルはAPI開発者を対象
このオープンソーススキルは、Claude APIまたはエージェント上で開発を行う開発者向けにClaude Codeに組み込まれている。Claude Codeユーザーには必須ではなく、非Claudeモデルでは効果が低減する。プロジェクトがAnthropic SDKをインポートするか、ユーザーが/claude-apiと入力すると起動し、Python、TypeScript、Java、Go、Ruby、C#、PHP、cURLのAPIドキュメントを読み込む。Messages APIとManaged Agents(Anthropic管理のステートフルエージェントでサンドボックス環境を備える)を対象とする。
cost-optimizeとmigrateはモデルアップグレードを支援
/claude-api cost-optimizeは実際のAPI使用状況を分析し、個別に承認またはスキップ可能な優先順位付きの節約提案を生成する。キャッシュ設定、トークンの冗長性、バッチ処理の機会、努力レベル、モデル選択をチェックする。/claude-api migrateは、範囲の確認、ファイルの分類、破壊的変更の適用により、既存のAPIコードを新しいモデルに移行する。例として、Fable 5からFable 5.1、またはOpus 4.6からOpus 4.8への移行が挙げられる。
prompt-auditは6つのアンチパターンを特定
/claude-api prompt-auditは、プロンプトおよびスキルファイルをスキャンし、時代遅れまたは問題のあるパターンを検出する。6つのアンチパターンは、検証儀礼、徹底性・強調ブースター、必須手順・スクラッチパッドの足場、古いFew-shot例、矛盾するルール、時代遅れの設定である。監査は、特定のファイル、行番号、問題パターンを含むレポートと、修正提案を含む差分を出力する。
アンチパターンは最先端モデルに悪影響
最先端モデルでは、「作業を再確認せよ」という指示が文字通りに受け取られトークンを浪費する可能性がある。「できるだけ詳細に」といった強調表現は冗長性や不要なツール呼び出しを引き起こす。強制的なステップバイステップのスクラッチパッドはネイティブの推論と重複する。古いFew-shot例は単純なタスクで長い推論を誘発する。矛盾するルールは文字通りに遵守される。時代遅れの思考予算はClaudeプラットフォームによって拒否される可能性がある。これらのパターンは時間とともに蓄積され、モデルアップグレード時にパフォーマンスを静かに低下させる。
実際のベンチマーク事例がプロンプト監査の影響を示す
Opus 4.8からOpus 5への移行における内部カスタマーサービスのベンチマークでは、「二度確認せよ」などの検証儀礼が繰り返し作業を引き起こしトークンを浪費し、強調ブースターが数十回の不要なシステム検索を誘発した。プロンプト監査は、この設定においてLLMのパフォーマンスを大幅に改善し、コストを削減した。/claude-apiスキルは、Fable 5.1においてプロンプトキャッシング価格が75%低下し、低い努力レベルが従来の高い努力レベルに匹敵するようになったことを背景に位置づけられており、古いプロンプトのクリーンアップが必要である。
Anthropicガイドはリテラルで気取らない言語を要求
Anthropicのガイダンスは、すべての気取った散文を排除するよう求めている。文字通りの表現が利用可能な場合は、比喩や飾り言葉、あるいは意味を伝えるのではなく書き手のパフォーマンスを示す言語ではなく、それを用いるべきである。