AI駆動開発×Claude Skills入門

研修資料｜法人向け IT研修シリーズ AI駆動開発 × Claude Skills 入門 実務で使えるスキル設計の基礎 ― 認知科学に基づく学び方とプロンプト集つき 対象：新人〜中堅エンジニア／文系出身メンバーも歓迎 形式：Why → What → How 構成／演習つき 根拠：Anthropic公式資料＋査読済み論文に準拠 うさうさ研修工房

AGENDA 本日の流れ 01 Why なぜ今「スキル設計」が必要なのか 02 What Claude Skillsとは何か（定義と構造） 03 How 実務でのスキル設計・活用ステップ 04 学び方 4週間ロードマップとプロンプト集 AI駆動開発 × Claude Skills 入門 2

WHY ｜ 課題 「毎回、同じ説明」を繰り返していませんか？ 属人化 再現性の欠如 認知負荷の増大 ベテランが暗黙知として持つ「コツ」が、 同じ依頼でも、プロンプトの書き方次第で 毎回、背景・制約・出力形式を長文で説 チームに共有されない 出力品質がばらつく 明し直すコストが大きい AI駆動開発 × Claude Skills 入門 3

WHY ｜ 認知科学の視点 「都度説明」はワーキングメモリを圧迫する 認知負荷理論（ Cognitive Load Theory） 学習の転移（ Transfer of Learning） Sweller（1988）は、学習・作業時の負荷を課題内在的負荷／課題外在的負荷／学 習関連負荷の3種に整理した。毎回プロンプトを一から書く行為は「外在的負荷」を 増やし、本質的な思考に使える容量を奪う。 Mayer（2009）のマルチメディア学習理論では、構造化さ スキル化＝外在的負荷の恒久的な削減 位」への切り出しは、個人の暗黙知を組織の形式知に 手順・制約・出力形式を「SKILL.md」として一度定義すれば、以降は呼び出すだけで よく、説明の再構築コストがゼロに近づく。 転移させる仕組みそのものである。 AI駆動開発 × Claude Skills 入門｜出典：Sweller 1988; Mayer 2009 れた手順（Why/What/How）が新しい場面への応用＝ 転 移を促すと整理される。スキルという「再利用可能な単 4

WHY ｜ 業界動向 AI駆動開発は「モジュール化」の段階へ 能力が上がるほど、課題は「精度」から「設計」へ移る • Alenezi & Akour (2025, Applied Sciences)：AI駆動型ソフトウェア工学の実践 レビューで、モデル単体の精度向上より「文脈・ワークフローの構造化」が実 務効果を左右すると指摘。 • Hughes et al. (2025, Journal of Computer Information Systems)：エージェント 型AIの多分野専門家分析で、再利用可能な「役割・手順の外部化」が組織導 入の鍵と結論。 出典：Case Studies and Reflections on Agentic Software Engineering（arXiv, 2026）— HumanEvalベンチマーク の推移 AI駆動開発 × Claude Skills 入門 5

WHAT ｜ 定義 Claude Skillsとは何か 「指示・スクリプト・リソースをまとめたフォルダ」を、 Claudeが必要な時だけ動的に読み込み、専門タ スクの遂行力を高める仕組み Anthropic公式定義（2025年10月発表）に基づく 新人研修の「引継ぎ書」に近い MCPとは役割が異なる ポータブルで軽量 Anthropicは「新人向けオンボーディング資料を作る感 MCPは外部システムへの「接続」、Skillsは組織固有の 特別なインストールや依存関係設定が不要。フォルダご 覚」に例える。手順・注意点・サンプルを1つにまとめる。 「やり方・専門知識」の注入。両者は併用できる。 とコピー・共有すればそのまま動く。 AI駆動開発 × Claude Skills 入門｜出典：Anthropic Engineering Blog (2025) 6

WHAT ｜ 構造 スキルの中身は驚くほどシンプル my-skill/ SKILL.md の最小構成イメージ --- ● SKILL.md 必須。Markdown形式の指示書（メタデータ＋手順） name: weekly-report description: 週次報告書を社内書式で 自動生成するときに使用 --- ○ reference/ 任意。詳細ガイド・テンプレート・サンプル集 # 週次報告スキル 1. 対象期間のタスクを整理 ○ scripts/ AI駆動開発 × Claude Skills 入門 任意。必要時のみ実行されるPythonロジック 2. 社内テンプレート形式に整形 3. 未完了タスクを次週欄へ転記 7

WHAT ｜ 仕組み 3段階で「必要な分だけ」読み込む（ Progressive Disclosure） Lv.1 Lv.2 Lv.3 常時読込み タスク時に読込み 必要時のみ読込み description（数十語）が常にAIの視界にあり、 該当スキルと判断されたらSKILL.md 本体を読 reference/ や scripts/ は、実際にその情報・処 「どのスキルを使うべきか」を判断する材料に み込み、具体的な手順を取得する 理が必要になった瞬間だけ読み込まれる なる 狙い：コンテキストウィンドウを圧迫せず、多数のスキルを併存させても速度と精度を保つ設計思想 AI駆動開発 × Claude Skills 入門｜出典：Anthropic Engineering Blog (2025) 8

WHAT ｜ 利用範囲 どこで使えるのか Claude.ai Claude Code Agent SDK Developer Platform チャット上でファイル生成・分析タス クに適用 ローカル開発環境でのコーディング 支援に適用 自社エージェント構築時に組み込 み可能 APIベースの業務システムに統合 提供プラン： Pro／Max／Team／Enterprise（フィーチャープレビュー・コード実行の有効化が必要）、 Claude Code／API利用者はベータ提供 AI駆動開発 × Claude Skills 入門｜出典：Anthropic Engineering Blog (2025) 9

HOW ｜ 実践 スキル作成 5ステップ 1 棚卸し 繰り返している依頼・説明を洗い出す（週次報告、議事録整形 等） 2 境界を決める 「いつ使うか」を descriptionで一文にできるまでタスクを絞る 3 手順を書く SKILL.mdに前提・制約・出力形式を Why/What/Howで整理 4 試す 実際のタスクで呼び出し、出力のブレをチェック 5 育てる 例外パターンを reference/に追記し、版を重ねる AI駆動開発 × Claude Skills 入門 10

HOW ｜ 実践 descriptionの書き方が「発見性」を決める 避けたい書き方 「レポート作成を手伝います」 推奨する書き方 「週次進捗を社内フォーマット（部署名・完了率・次週予定）で Excel報告書に整形する場合に使用」 → 抽象的すぎて、AIが「いつ」使うべきか判断できない。似た他 スキルとの区別もつかない。 AI駆動開発 × Claude Skills 入門 → 対象業務・条件・出力形式を明示し、判断材料を具体化。 11

HOW ｜ 注意点 スキルは「実行力」を持つため監査が必須 スキルは指示とコードを通じて Claudeに新たな能力を与える。悪意あるスキルは環境に脆弱性をもたらし、意図しないデータ 持ち出しにつながり得る。 信頼できる配布元のみ導入 未知の配布元は、まず内容を精読 AI駆動開発 × Claude Skills 入門｜出典：Anthropic Engineering Blog (2025) 依存パッケージ・同梱リソースを確認 外部ネットワークへの接続指示に注意 12

HOW ｜ 実務例 研修講師業務での活用イメージ 資料骨子スキル 配色チェックスキル 講師ガイド変換スキル Why/What/Howの型に沿って新人研修の骨 Rose Deckブランドカラー・コントラスト基準を PPTX骨子からWord講師ガイドを一貫した書 子を自動生成 自動適用 式で生成 ポイント：単発の高品質な出力より、「毎回同じ品質を再現できる」ことが法人研修コンテンツ制作では価値になる AI駆動開発 × Claude Skills 入門 13

ROADMAP 4週間・学び方ロードマップ Week1 Week2 Week3 Week4 観察 試作 検証 横展開 自分が繰り返し行っているAI依頼を 最も頻度が高い1件をSKILL.mdとし チームメンバーに使ってもらい 成功パターンをreference/化し、他 記録する て書き出す フィードバックを得る 業務へ応用 AI駆動開発 × Claude Skills 入門 14

まとめ ✓ スキル化は「都度説明の認知負荷」を恒久的に減らす仕組み ✓ SKILL.mdは新人向け引継ぎ書と同じ発想で書ける ✓ descriptionの具体性が「発見性」＝実務での再利用率を決める ✓ 信頼できる配布元の選定と内容監査は運用上の必須事項 参考文献 ・Sweller, J. (1988). Cognitive Load During Problem Solving. Cognitive Science, 12(2). ・Mayer, R. E. (2009). Multimedia Learning (2nd ed.). Cambridge University Press. ・Alenezi, M., & Akour, M. (2025). AI-Driven Innovations in Software Engineering. Applied Sciences, 15(3). ・Hughes, L. et al. (2025). AI Agents and Agentic Systems. Journal of Computer Information Systems, 65(4). ・Anthropic (2025). Equipping Agents for the Real World with Agent Skills. Anthropic Engineering Blog. AI駆動開発 × Claude Skills 入門 15

次の一歩 今日から1つ、あなたが繰り返している「AIへの依頼」を書き出してみましょう。 それが最初のスキルの原型になります。 うさうさ研修工房 AI駆動開発 × Claude Skills 入門 16