【要約】AIへの指示力とは「"未知"を言語化する力」だった ―― Anthropicのブログを読んで [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
開発者がAIエージェントにコーディングを依頼する際、指示の解像度が不足しているために、実装の品質が低下する問題に直面する。指示が不十分だと、AIは不足情報を推測で補い、意図しない挙動を引き起こす。具体的には以下の課題が生じる。
- ・指示が曖昧な場合、AIが「たぶんこうしてほしいのだろう」と推測して実装を進めてしまう。
- ・指示が細かすぎると、AIの柔軟性が失われ、開発の効率が低下する。
- ・開発者自身が「何を分かっていないか」を把握できていないことが、成果物の質を制限するボトルネックとなる。
// Approach
開発者が持つ「地図（知識）」と実際の「土地（コードベース）」の乖離、すなわち「未知」を特定し、言語化するアプローチを採用する。未知を4つの分類（既知の既知、既知の未知、未知の既知、未知の未知）に整理し、フェーズごとに以下の手法を用いる。
- ・実装前：Blind Spot Pass（未知の洗い出し）、インタビュー（AIによる質問）、プロトタイプ作成による検証を行う。
- ・実装中：implementation-notes.md を用い、計画から逸脱した判断理由を記録する。
- ・実装後：変更内容のピッチやクイズを通じて、実装内容の正確性を検証する。
// Result
AIとの協調開発において、開発者の役割を「実装者」から「未知の定義者」へとシフトさせ、開発品質を向上させる。このアプローチにより、以下の成果が得られる。
- ・実装の早い段階で「未知」を特定することで、修正コストの高い手戻りを防げる。
- ・実装意図を記録することで、将来の自分や他者がAIを用いてコードを理解する際の精度が向上する。
- ・「たぶん」という推測に基づくメンテナンスを、「なるほど」という確信に基づく作業へ転換できる。
Senior Engineer Insight
> 開発の主権が「コードを書くこと」から「未知を定義すること」へ移行している。AIエージェントの性能向上に伴い、人間のボトルネックは「言語化能力」に集約される。実装ノートの運用は、単なる備忘録ではない。AIに対する「コンテキスト注入」として捉えるべきだ。これにより、技術負債の蓄積を抑えつつ、AI主導の開発サイクルを高速化できる。現場では、Blind Spot Passを標準的なレビュー工程に組み込むことを推奨する。