エージェント初出 7/30 07:30
.claude/agentsに置いたのに、サブエージェントが直接呼べなかった話
https://zenn.dev/topics/ai/feed2026/7/30
AI要約
Claude Codeでサブエージェントが直接呼び出せなかった問題について解説。`.claude/agents`に定義ファイルを置いても期待通りに動作しないケースがあり、その原因と解決策を示唆。
AI要点
- Claude Codeでは`.claude/agents`に置いたMarkdownファイルでサブエージェントを定義できる。
- サブエージェントの定義と、それを呼び出せる実行環境は別物である。
- サブエージェントは、指示書(定義ファイル)として機能する。
- サブエージェントに「見つけさせる」ことと、スキルで「直す」連携が有効。
- スキルとサブエージェントの違いを理解し、使い分けることが重要。
なぜ重要か
サブエージェントの定義を独立した指示書として捉え、実行環境と切り離して考えることで、AI開発における専門タスクの分担と連携が容易になり、開発チームのような協調作業が可能になる。