Agent Skill は振る舞いとナレッジを分けて設計する
Hiroba による自動要約
Claude Code の社内導入に伴い、Agent Skill の設計方針を実践した事例紹介。単一責任の原則を適用した後も、レビュー観点の追加時に自然言語スキルが膨張する課題に直面。振る舞い（実行手順）とナレッジ（確認観点）をファイル分離することで、メンテナンスコストを削減し継続的な改善を実現する設計パターンを提案。
読んで良かったら、シェアしてみてください。
同じタグの記事が他に 5349 件あります。
関連する記事
同じタグの記事
Google Drive の旅行動画を、自作 MCP で Claude に vlog へ編集させる
ZennGoogle Drive 上の旅行動画を Claude が 1 本の vlog に編集する仕組みの構築記録。Cloud Run に 1 MCP = 1 サービスで載せた drive・ffmpeg・veo・lyria 等のサーバー群を claude.ai のカスタムコネクタに登録し、スマホからの指示に対応。FastMCP の GoogleProvider による許可リスト認証、操作を限定した ffmpeg ツール設計、編集ルールの Skills 化まで解説。リモート MCP を自作する開発者向け。
Anthropic の新ガイド (10/22): 多くの Agent は Subagent を減らすべき、メインループ 1 本と Skills・ツール検索で代替。「Claude Code の system prompt を 80% 以上削減」にも言及
RedditAnthropic が Agent 設計ガイド「When to fold subagents into your main agent loop」を公開。1 モデル・1 コンテキスト・1 ツールループを基本とし、手順は Skills、制約や参照はツールへ移す方針を提示。Subagent はコンテキスト肥大や並列処理が必要な場合に限定。ツール定義は 30-50 個超で選択精度が落ちるためツール検索を推奨。Claude Code の system prompt を 80% 以上削減した事例、eval 先行の移行手順、/claude-api 向け新 Skills と GitHub の kit も紹介。Subagent を多用する Claude Code ユーザーや Agent 開発者向け。
サブエージェントはメインループに「畳む」べきか？Anthropicの記事をモックECサポートで実測
QiitaAnthropic の記事「When to fold subagents into your main agent loop」の主張を、架空 EC サポートのモック環境で API を使って検証した実測レポート。シングルループ + Skills 構成は組織図どおりのオーケストレーター + サブエージェント構成より全 12 タスクで平均約 2.1 倍高速、コストは 1.7〜2.6 倍安価。品質差は天井効果で検出できず。Agent 設計でサブエージェント分割を検討中の開発者向け。
Claude Codeのクラウド Projects にプラグインを持ち込むときのハマりどころメモ
ZennClaude Code の Projects（ベータ版）でローカルの自作プラグインをクラウド thread に持ち込もうとした際、公式ドキュメントと実際の動きの差異を複数発見。リポジトリの settings.json で有効化したプラグインはクラウドで読まれない、Project settings に Plugins 項目がない、bin/ を持つプラグインがスキップされるなど、実装段階での問題点を検証結果とともに記録。