tac-tac-go
← Clips
zenn.dev 2026年4月30日

【Claude Code】CLAUDE.md・skills・agents を整備して開発体験が劇的に変わった話

元記事を読む ↗

【元記事】https://zenn.dev/linkedge/articles/27c38cdd9bedc6

3行まとめ

  • Claude Codeを「入れるだけ」ではなく、CLAUDE.md・skills・agentsで「育成」すると開発体験が劇的に向上する
  • CLAUDE.mdで環境理解・プロダクト理解の問題を解消し、skills/で繰り返し作業を定形化、agents/で専門タスクを独立コンテキストで実行
  • 新入社員のオンボーディングと同じく、プロジェクトの前提知識・ルール・タスクの進め方をAIに渡すことで真価を発揮する

要約

背景・課題

  • VSCode拡張を入れただけでは、環境理解不足での的外れコマンド・プロダクト理解不足でのピントずれ・毎回ゼロから把握する時間ロスが頻発

アプローチ

  • CLAUDE.md:プロジェクト概要・技術スタック・ディレクトリ構成・コーディング規約・実行環境を記述し、起動時に自動読み込み
  • skills/:rspec・rubocop・update-claude-mdなど繰り返し作業の手順を定義
  • agents/:performance-analyzerなど専門性の高いタスクをサブエージェント化し、メイン会話のコンテキスト圧迫を防ぐ

成果・ポイント

  • CLAUDE.mdで問題①〜③がほぼ解消、skills/で「テスト書いて」の一言でチーム規約に沿った実装が可能に
  • agents/で長時間のパフォーマンス分析も安定して実行可能
  • 権限設定(permissions・hooks)をチームで揃えることで、本番環境接続や破壊的コマンドの事故を防止