MCU ベース IoT システムアーキテクチャ概観

Agent Skills が使われない・効かない場合の7つの原因を公式ドキュメントに基づいて体系化。name とフォルダ名の不一致、description の不備、本文の冗長さなど、診断順に対策を提示。Skills は3段階に分けて読み込まれるため、1段目の description で AI の判断が決まる仕組みを理解することが重要。

長期案件でClaudeやChatGPTを使う際、大量のファイルをAIに記憶させるのではなく、参照方向の管理と探索ルールを構造化することで対応した実運用例。00番を「正典」として現在の採用判断を一元管理し、深掘りルールを外部ファイル化することで、モデルの忘却や読み落としを前提とした安定運用を実現。

artifact-design Skill は Claude Code に組み込まれたデザイン指針で、HTML や Markdown の成果物を単なる表示から「見る人の目的に合わせた見た目」へ整える役割を担う。題材・読者・目的から配色やレイアウトを判断し、テンプレートに頼らず既存デザインを優先しながら、資料は資料らしく、UI は UI らしく作る設計になっている。

Claude等のAIでコード修正を何度依頼しても治らない場合、既存仕様の維持に優先度を置くAIの特性が原因である可能性がある。バグ原因が仕様にある場合、「仕様変更の候補を列挙させてから修正を依頼する」2段階プロンプトにより、問題解決が進みやすくなる。