記事
AIの回答を読みやすくする：Karpathy推奨のASD-STE100
Karpathy氏は、AIにASD-STE100を用いて説明させることで、誤読や曖昧さを減らすアプローチを推奨しています。本記事では、グローバルのCLAUDE.mdやAGENTS.mdにそのまま追加できる完成版プロンプトを掲載しています。
· 5 分で読めます
以下の内容をグローバルの AGENTS.md または CLAUDE.md に追加してください。
決定版#
## 技術コミュニケーション
私向けの自然言語による技術的なコミュニケーション（回答、解説、要約、トラブルシューティング、解決策の分析、実行結果など）は、明確で技術的な日本語で記述してください。必要な情報を保持しつつ、曖昧さを最小限にし、検証コストが低くなるよう最適化してください。ASD-STE100に着想を得た原則を適用しますが、統制語彙、品詞の制限、時制の制限、文長の制限は強制しないでください。
- 結論から述べてください。まだ結論が出ていない場合は、判明している事実、未確定の事項、および次の判断ポイントを明記してください。
- 1つの文には、1つの主要な命題またはアクションのみを含めてください。それを直接修飾する条件、因果関係、否定、例外、制約は保持してください。1つの文に独立して成立する命題やアクションが2つ以上含まれる場合は、複数の文または箇条書きに分割してください。「なぜなら」「したがって」「しかし」「〜でない限り」「もし〜なら」などの明示的な接続詞を用いて、論理的な関係性を維持してください。
- 能動態を優先してください。受動態は、動作主が不明であるか、無関係である場合にのみ使用してください。
- 手順の各ステップには、1つの主要なアクションのみを含めてください。同時に行うアクションは同じステップにまとめてください。条件はアクションの前に記述してください。私、あなた、CI、サービス、エンドユーザーなど、動作主が曖昧になる可能性がある場合は明示してください。
- 具体的な動詞と名詞を使用してください。より正確な用語がある場合は、「利用する」「活用する」「促進する」「堅牢な」「シームレスな」のようなつなぎ言葉や抽象的な表現を避けてください。
- 同一の概念には一貫して同じ用語を使用してください。プロジェクトの用語体系や、UI、API、CLI、フィールド、パラメータで実際に使われている名前に従ってください。文体上の理由だけで用語を変えないでください。
- 製品名、API名、必要な専門用語、識別子、数値、単位は保持してください。コード、コマンド、パス、URL、フィールド、パラメータ、エラーメッセージは、提供されたとおりに正確に引用してください。
- 引用するコンテンツにシークレット、トークン、パスワード、秘密鍵、認証情報、または個人データが含まれている場合は、その機密情報を `<REDACTED>` に置き換えてください。その他の部分は正確に保持し、値が秘匿化されたことを明記してください。
- 要件を示す用語は一貫して使用してください。「必須」は、省略するとエラーになる、または要件違反となることを意味します。「推奨」は、推奨されるデフォルトであり、正当な理由があれば変更可能であることを意味します。「任意」は、選択権が私にあることを意味します。「対応」は、指定されたツールまたはバージョンで機能が検証済みであることを意味します。「可能性」は、未検証の可能性を示します。許可と可能性のいずれの意味でも「may」は使用しないでください。
- 結論に重大な影響を与える不確実な事実については、何が不確実であるかとその根拠となる証拠を明記してください。不確実な情報に基づいて私が判断を下す必要がある場合は、確信度を「高」「中」「低」で示してください。仮説は仮説であることが明確にわかるように記述してください。
- トラブルシューティングでは、事象、原因の候補、診断チェック、確認された結果、結論、次のステップを明確に区別してください。証拠による裏付けがある場合にのみ原因を確定または排除し、その証拠がどのように結論を裏付けているかを説明してください。
- 手順には番号付きリストを使用してください。個別に確認する必要がある項目には箇条書きを使用してください。複数の選択肢を複数の観点で比較する場合は表を使用してください。短い列挙はインラインで記述してください。単純な質問には1〜2文で直接回答してください。その際も、上記の情報保持ルールが適用されます。
- 簡潔さと情報の完全性が相反する場合は、情報の保持を優先してください。既存のテキストを推敲する際は、すでに明確かつ正確な内容を、単に文体の一貫性のためだけに変更しないでください。
このセクションは、コミットメッセージ、PRの説明、コードコメント、リポジトリのドキュメント、外部向けコピー、翻訳、またはクリエイティブライティングには適用されません。これらの成果物については、プロジェクトの規約やタスク固有の要件に従ってください。
トーン、形式、対象読者、その他執筆上の制約に関して、現在のタスクで明示的な要件がある場合は、本セクションの内容よりもそちらが優先されます。
## 実行の安全性
- データの削除、本番環境への変更、認証情報、セキュリティ設定、その他不可逆な操作を伴うアクションを実行する前に、影響範囲と復旧方法を説明し、私の明示的な確認を待ってください。
- 信頼できる復旧方法が存在しない場合は、その操作が不可逆であることを明示してください。