Upgrade to Pro — share decks privately, control downloads, hide ads and more …

その作業、繰り返していませんか? そのお悩み、「Skills」で解決!! 繰り返し作業の自動化...

その作業、繰り返していませんか? そのお悩み、「Skills」で解決!! 繰り返し作業の自動化で、より 本 質的な事をしよう

claude code、copilot cliなどの拡張機能として、「Skills」があります
この「Skills」導入によって日々の業務が楽になったので、Skillsの概要~実践まで網羅的に解説しています

Avatar for Izumin

Izumin

April 04, 2026

Other Decks in Technology

Transcript

  1. 自己紹介 泉 拓真 tama チーム / バックエンドエンジニア 趣味 🚶 散歩(高校の友達と年1回

    30km !) 🎬 Netflix(トークサバイバー見てほしい!) ⛰️ 登山にも挑戦したい 経歴 2025年3月 佐賀大学 理工学部 卒業 2025年4月〜 株式会社HRBrain 入社 2
  2. アジェンダ 01. なんで Skills の話? 普段の体験と布教の動機 02. Skills とは? 仕組みと2つの使い方

    03. ポイントと注意点 実践で役立つコツと落とし穴 04. 実際の使い道 具体的な活用例と弱点 3
  3. Skills とは? エージェント に「専門skill」を与えられる仕組み。 ※ディレクトリ構造は一例です。copilot CLIでは「.github/skills」でも読み込まれます .claude/ └── skills/ └──

    my-skill/ ├── SKILL.md ├── reference.md # 詳細なAPIドキュメント(必要な時に読み込まれます) ├── examples.md # エージェントの回答例など(必要な時に読み込まれます) └── scripts/ └── helper.py # 実行可能なスクリプト(必要な時に読み込まれます) 7
  4. SKILL.md のフォーマット --- name: create-draft-pr description: | ghコマンドでdraft PRを作成する。コード差分を自動解析してdescriptionを生成。 PR作成、draft

    PR、PR作成。 disable-model-invocation: false # true = 手動呼び出しのみ(副作用がある操作に) user-invocable: true # false = Claude自動呼び出しのみ --- ## ここから本文(呼び出し時のみ読み込まれる) 1. git 状態の確認 2. コード差分を解析して description を生成 ... 8
  5. 2つの使い方 1. エージェントが自動で読み込む description のキーワードにマッチすると エージェントが自動参照し、skillを使用 例: 「振り返りにアドバイスして」→ reflect-advisor が自動発火

    プロジェクトのコンテキストを踏まえた成 果物になりやすい 2. スラッシュコマンドで手動実行 /skill-name で明示的に呼び出す 繰り返し作業(Issue作成、PRレビュー、 テスト生成など)の自動化に向く 9
  6. Skill 使用時のポイントと注意点 ポイント①: description はユーザーが言いそうな言葉を、簡潔に エージェントを起動する際に、descriptionだけが読み込まれる。そのため、自動トリガーの精度は description の質で決まる — 曖昧すぎると誤発火、具体的すぎるとヒットせずに無反応

    ポイント②: SKILL.md 本文は最小限に、詳細は references/ へ 本文は呼び出し時のみ読まれるが長すぎるとコンテキスト消費が増える。詳細なドキュメント・パターン集・ スクリプトは references/ に分割して SKILL.md 本体をシンプルに保つ(500行以下にしたい) 注意点: 副作用のある操作は disable-model-invocation: true を忘れずに deploy / push / Slack 送信など、設定しないと意図せず自動実行されるリスクがある 11
  7. 実例 ①: Draft PR を自動生成する --- name: create-draft-pr description: ghコマンドを使ってdraft

    PRを作成する。コード差分を自動解析して descriptionを生成し、ユーザーへの質問は最小限(変更の背景のみ)に絞る。キーワード:draft prの作成、pr作成。 --- ## フロー概要 1. git 状態の確認 2. コード差分を自動解析して description 草案を生成 3. **変更の背景・意図を1回だけ確認**(任意) 4. description 全体を提示して最終確認 5. draft PR を作成 ポイント: /create-draft-pr と打つだけで完結。ブランチ名から Issue 番号も自動判定 13
  8. 実例 ②: 単体テストの作成 --- name: tama-test description: TAMA/appテスト作成。テスト作成・テスト追加・レビュー時に使用。 apps/tama/app/internal/**/*_test.go作成・編集時に使用。 ---

    # TAMA Test - テスト作成ガイドライン ## レイヤーごとのテスト | レイヤー | 手法 | |---------|------| | handlers | Mock版でテスト | | repository | TestDB疎通版 | | usecase | Mock利用してテスト | 14
  9. まとめ 1 手順が決まった作業は迷わず Skills に切り出す。さらに、SKILL.mdは最小限にし、コンテキスト節約・ 精度up 2 description の質が自動トリガーの精度を決める。 3

    skill-creator を使えば作るのも楽。ただし外部skillのインストールは内容を確認してから + 【ぼやき】このスライドは「marpでスライドを作成するskills」で作成しました😏 17