#開発効率化

AIで自動化コードを書くとき、処理をサブタスクに分けるか・チームで並列実行するか・そのまま書くか——迷いがちな3パターンの選び方を、実際の運用例から整理します。

エージェントに作業を振っても毎回出力がブレる――Claude Codeのsubagent運用で「指示プロンプトに必ず書く5項目」を決め、SKILL.mdを機械チェックで揃えた設計を紹介します。

Claude Codeのサブスクプランで104本のskillを運用する中、Opus/Sonnet/Haikuをどう配分したかの実録。料金単価ではなく5時間ウィンドウ内のスループットとOpusのレイテンシから導いた3層ルールを、skillの実データとともに公開します。

Claude Code Skills を 50 個以上運用してきた中で効いた判断を、命名・粒度・description・フォールバック・lint の 5 観点で整理。SKILL.md の書き方より、どう育てたかを Why ベースで共有します。

skill.md の書き方を入門者向けに解説。frontmatter の仕様書を熟読する前に、Claude Code に「skill 化して」と頼むのが一番の近道になる理由と、作った後の運用（description 設計・スキル競合・肥大化対策）の勘所を、実運用のエピソード付きで紹介します。

Claude Code Skillsを複数プロジェクトで使い回すためのポータブル設計を解説。3層コンフィグマージ、_lib/共有ライブラリ、外部スキルのsymlink統合など、70+スキルの実運用から得たエコシステム構築の実践知。

Claude Code Skillsの設計パターンを上級者向けに解説。JSONスキーマによる型安全性、Auto-Retryプロトコル、3層コンフィグマージなど、95スキルの運用から得た実践知を紹介。

Claude Codeヘビーユーザーが、Codexとの共存運用を調査・検証。Skills統一管理のsymlink共有やプロジェクト別ツール選定マトリクスなど、実際に試した範囲で正直にレポートします。

AIエージェントが同じエラーを繰り返す根本原因はセッション間記憶の欠如。構造化ログ・8軸パターン検出・SKILL.md自動修正の3パターンで、Claude Codeのself-correctionをセッションをまたいで永続化する実装を解説。エラー処理設計の具体例とコード付き。