専門知識を盛り込みましょう。仕様書には、経験豊富な開発者やコンテキストに精通した人だけが理解できる洞察を反映させる必要があります。例えば、eコマースエージェントを構築していて、「商品」と「カテゴリ」が多対多の関係にあることが分かっている場合は、それを明確に記述してください(AIが推測してくれるとは想定しないでください。推測できない可能性もあります)。特定のライブラリが非常に扱いにくいことで有名な場合は、回避すべき落とし穴についても言及してください。つまり、仕様書にはあなたのメンタリングを注ぎ込むということです。仕様書には、「ライブラリXを使用する場合は、バージョンYのメモリリーク問題に注意してください(回避策Zを適用してください)」といったアドバイスを含めることができます。このレベルの詳細さこそが、平均的なAI出力を真に堅牢なソリューションへと変えるのです。なぜなら、AIをよくある落とし穴から遠ざけることができたからです。
また、好みやスタイルガイドライン(例えば「Reactではクラスコンポーネントではなく関数型コンポーネントを使用する」など)がある場合は、仕様にそれを記述してください。そうすることで、AIがあなたのスタイルをエミュレートします。多くのエンジニアは、仕様に小さな例を盛り込むこともあります。例えば、「すべてのAPIレスポンスはJSON形式である必要があります。例:エラーの場合は{“error”: “message”}」などです。簡単な例を挙げることで、AIが希望するフォーマットを正確に理解できるようになります。