Question 1

AIエージェントにおいて、使わないスキルが残っているとどのような問題が生じるか？

Accepted Answer

使っていないスキルでも、存在するだけで説明文の読み込みに毎回コンテキスト（記憶領域）が消費される スキル説明文に割り当てられるコンテキストの枠は全体の1パーセントまでに制限されている 枠を超えると説明文が自動的に削られ、AIが作業に適したスキルを正しく選べなくなる恐れがある

Question 2

指示ファイル（agents.md）の精査が重要な理由と、公式が推奨する目安は何か？

Accepted Answer

無駄な指示や矛盾した記述があると、AIの誤動作の原因になったりトークンを浪費したりする 公式ドキュメントでは「これを消したらClaudeは間違えるか」という観点で1行ずつ精査することが推奨されている agents.mdのファイルサイズは、1ファイルあたり200行未満が目安とされている

Question 3

「/doctor prompt-audit」コマンドとはどのような機能か？

Accepted Answer

Claude Codeのバージョン2.1.283から利用可能になった指示監査コマンドである AIにとって不要な指示や矛盾した内容、使われていないスキルの説明文などをまとめて監査・修正できる 手動で1行ずつ精査する手間を省き、コマンド1つでプロジェクト内の指示を効率的に整理できる

Question 4

実際に「/doctor prompt-audit」を実行したことで、どのような改善が得られたか？

Accepted Answer

壊れて起動しない古いClaude Codeのバージョンが優先して呼ばれていた環境設定の問題が発覚した 未使用のスキル5つとプラグイン1つを特定し、会話ごとに無駄にしていた約500トークンを削減できた agents.mdの指示を約18パーセント削減し、重複や古い記述など計23箇所の問題が修正された

Question 5

監査で大量の修正箇所が見つかった場合、どのように修正を進めるべきか？

Accepted Answer

大量の修正を1度にまとめて反映させず、段階的に対応することが望ましい 調査結果をまとめさせ、AIエージェントにPR（作業単位）の分割計画を作成させる 作成された分割計画に沿ってPR1つ分ずつAIに修正を指示することで、安全かつ着実に修正を進められる

Podcast振り返り

AIの無駄な指示と壊れた設定を、/doctor prompt-auditで一掃