MochiuWiki : SUSE, EC, PCB
案内
メインページ
最近の更新
おまかせ表示
MediaWiki についてのヘルプ
ツール
リンク元
関連ページの更新状況
特別ページ
ページ情報
We ask for
Donations
検索
個人用ツール
ログイン
Toggle dark mode
名前空間
ページ
議論
表示
閲覧
ソースを閲覧
履歴を表示
Claude Codeの設定 - SKILLのソースを表示
提供: MochiuWiki : SUSE, EC, PCB
←
Claude Codeの設定 - SKILL
あなたには「このページの編集」を行う権限がありません。理由は以下の通りです:
この操作は、次のグループのいずれかに属する利用者のみが実行できます:
管理者
、new-group。
このページのソースの閲覧やコピーができます。
== 概要 == SKILLファイルは、Claude Codeのスキル機能を定義するためのファイルである。<br> <br> スキルは、特定のタスクやワークフローを実行するための再利用可能なコマンドである。<br> SKILLファイルを作成することにより、頻繁に実行する操作を標準化し、チーム全体で共有できる。<br> <br> SKILLファイルは以下に示す特徴を持つ。<br> * 再利用可能なワークフローの定義 * パラメータと引数の受け渡し * Markdown形式での指示記述 * プロジェクト固有のツールアクセス制御 * ユーザとClaude双方からの呼び出し <br> SKILLファイルを使用することにより、以下に示すメリットが得られる。<br> * 作業の効率化 *: 頻繁に実行する操作を1つのコマンドで実行 * 一貫性の向上 *: 標準化されたワークフローをチーム全体で共有 * 知識の伝達 *: ベストプラクティスをスキルとして文書化 * 柔軟性の確保 *: パラメータを使用して動的にスキルを実行 <br> Anthropicsの公式SKILLを以下に示す。<br> Office系のSKILL等が存在する。<br> * https://github.com/anthropics/skills <br><br> == SKILLファイルの基本構造 == SKILLファイルは、YAMLフロントマターとMarkdown形式の指示から構成される。<br> <br> 基本構造を以下に示す。<br> <syntaxhighlight lang="md"> --- name: スキル名 description: スキルの説明 model: 使用するモデル (任意) temperature: 温度設定 (任意) allowedTools: 許可するツール (任意) --- # スキルの指示内容 Markdown形式でスキルの動作を記述する。 </syntaxhighlight> <br> SKILLファイルは、以下の2つのセクションで構成される。<br> * YAMLフロントマター *: スキルのメタデータを定義 * Markdown指示 *: スキルの動作を記述 <br><br> == YAMLフロントマター == YAMLフロントマターには、スキルのメタデータを記述する。<br> <br> ==== 必須項目 ==== * name *: スキルの識別子 *: これは、kebab-caseに自動変換される。 * description *: スキルの簡潔な説明 *: ユーザとClaude双方が参照する。 <br> nameの記述例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: commit-with-tests description: テストを実行してから変更をコミットする --- </syntaxhighlight> <br> ==== 任意項目 ==== * model *: スキル実行時に使用するモデルを指定 *: 指定しない場合、デフォルトモデルが使用される。 * temperature *: モデルの温度設定 (0.0から1.0) *: 低い値は決定論的、高い値は創造的 * allowedTools *: スキル実行時に許可するツールのリスト *: 指定しない場合、全てのツールが許可される。 * disallowedTools *: スキル実行時に禁止するツールのリスト *: セキュリティやパフォーマンス上の理由で制限する場合に使用。 <br> 任意項目の記述例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: review-code description: コードレビューを実行する model: claude-sonnet-4-5-20250929 temperature: 0.2 allowedTools: - Read - Grep - Glob --- </syntaxhighlight> <br><br> == Markdown指示 == YAMLフロントマターの後に、Markdown形式でスキルの動作を記述する。<br> <br> Markdown指示には、以下に示す内容を記述する。<br> * スキルの目的と動作の説明 * 実行するステップ * パラメータの使用方法 * 注意事項や制限事項 <br> Markdown指示の基本形式を以下に示す。<br> <syntaxhighlight lang="md"> --- name: スキル名 description: スキルの説明 --- # スキルの目的 このスキルは、[目的] を実行します。 ## 実行ステップ 1. ステップ1 2. ステップ2 3. ステップ3 ## 注意事項 - 注意事項1 - 注意事項2 </syntaxhighlight> <br> Markdown指示は、Claudeに対する指示として機能する。<br> 明確で具体的な指示を記述することにより、Claudeは正確にスキルを実行できる。<br> <br><br> == SKILLファイルの作成手順 == ==== ステップ 1 : スキルディレクトリの作成 ==== プロジェクトの <u>.claude/skills/</u> ディレクトリに、スキル用のディレクトリを作成する。<br> <br> # スキルディレクトリの作成 : mkdir -p .claude/skills/my-skill <br> スキルディレクトリ名は、kebab-caseで記述することを推奨する。<br> <br> ==== ステップ 2 : SKILL.mdファイルの作成 ==== スキルディレクトリ内に、<u>SKILL.md</u> ファイルを作成する。<br> <u>ファイル名は、必ず SKILL.md とする。</u><br> <br> # SKILL.mdファイルの作成 : touch .claude/skills/my-skill/SKILL.md <br> ==== ステップ 3 : YAMLフロントマターの記述 ==== SKILL.mdファイルの先頭に、YAMLフロントマターを記述する。<br> <br> 必須項目である <u>name</u> と <u>description</u> を必ず記述する。<br> <br> <syntaxhighlight lang="md"> --- name: my-skill description: 私のカスタムスキル model: claude-sonnet-4-5-20250929 temperature: 0.5 --- </syntaxhighlight> <br> ==== ステップ 4 : Markdown指示の記述 ==== YAMLフロントマターの後に、Markdown形式でスキルの動作を記述する。<br> <br> <syntaxhighlight lang="md"> # スキルの目的 このスキルは、特定のタスクを実行します。 ## 実行ステップ 1. ファイルを読み込む 2. 内容を解析する 3. 結果を出力する ## 注意事項 - ファイルが存在しない場合はエラーを報告する </syntaxhighlight> <br> 明確で具体的な指示を記述することが重要である。<br> <br> ==== ステップ 5 : スキルのテスト ==== スキルを作成したら、Claude Codeセッションで実行してテストする。<br> <br> # スキルの実行 : /my-skill <br> スキルが正しく動作することを確認し、必要に応じて修正する。<br> <br><br> == パラメータと引数 == SKILLファイルは、パラメータと引数を受け取ることができる。<br> <br> ==== 引数の受け渡し ==== スキルを実行する際、引数を渡すことができる。<br> <br> 引数の渡し方を以下に示す。<br> # 引数なし : /my-skill <br> # 引数あり : /my-skill arg1 arg2 arg3 <br> 引数は、スキルのMarkdown指示内で参照できる。<br> <br> ==== 引数の参照 ==== Markdown指示内で、渡された引数を参照することができる。<br> <br> 引数参照の記述例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: greet description: ユーザに挨拶する --- # 挨拶スキル ユーザが渡した引数を使用して挨拶します。 引数が渡された場合は、その名前で挨拶してください。 引数が渡されなかった場合は、"Hello, World!" と挨拶してください。 </syntaxhighlight> <br> Claudeは、ユーザが渡した引数を自動的に認識し、スキル内で使用する。<br> <br> ==== 複数の引数 ==== 複数の引数を渡すこともできる。<br> <br> 複数引数の記述例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: create-file description: ファイルを作成する --- # ファイル作成スキル 第1引数: ファイル名 第2引数: ファイルの内容 渡された引数を使用して、ファイルを作成してください。 例: /create-file test.txt "Hello, World!" </syntaxhighlight> <br> 引数の順序と意味を明確に記述することにより、Claudeは正確にスキルを実行できる。<br> <br><br> == スキルの呼び出し方法 == スキルは、ユーザとClaude双方から呼び出すことができる。<br> <br> ==== ユーザによる呼び出し ==== ユーザは、スラッシュコマンドを使用してスキルを呼び出す。<br> <br> # 基本的な呼び出し : /スキル名 <br> # 引数付き呼び出し : /スキル名 引数1 引数2 <br> スキル名は、YAMLフロントマターの <u>name</u> フィールドで定義した名前である。<br> <br> 呼び出し例を以下に示す。<br> * <code>/commit-with-tests</code> *: テストを実行してからコミットする * <code>/review-code src/main.js</code> *: src/main.jsのコードレビューを実行 * <code>/deploy production</code> *: 本番環境にデプロイ <br> ==== Claudeによる呼び出し ==== Claudeは、ユーザの要求に応じて自動的にスキルを呼び出すことができる。<br> <br> 例を以下に示す。<br> * ユーザが「テストを実行してコミットして」と要求 * Claudeが <u>/commit-with-tests</u> スキルを自動的に呼び出す <br> Claudeがスキルを呼び出す条件を以下に示す。<br> * スキルの <u>description</u> がユーザの要求に一致する * スキルが現在のコンテキストで関連性が高い <br> Claudeは、利用可能なスキルを認識し、適切なタイミングで自動的に呼び出す。<br> <br><br> == ツールアクセスの制御 == SKILLファイルでは、スキル実行時に使用できるツールを制御できる。<br> <br> ==== allowedTools : 許可するツール ==== <u>allowedTools</u> フィールドを使用することにより、スキルが使用できるツールを制限できる。<br> <br> 以下の例では、スキルは <u>Read</u>、<u>Grep</u>、<u>Glob</u> ツールのみを使用できる。<br> <u>Write</u>、<u>Edit</u>、<u>Bash</u> 等のツールは使用できない。<br> <br> <syntaxhighlight lang="md"> --- name: read-only-review description: ファイルを読み取り専用でレビュー allowedTools: - Read - Grep - Glob --- </syntaxhighlight> <br> ==== disallowedTools : 禁止するツール ==== <u>disallowedTools</u> フィールドを使用することにより、特定のツールを禁止できる。<br> <br> 以下の例では、スキルは <u>Bash</u>、<u>Write</u>、<u>Edit</u> ツールを使用できない。<br> その他のツールは全て使用できる。<br> <br> <syntaxhighlight lang="md"> --- name: safe-review description: 安全なコードレビュー disallowedTools: - Bash - Write - Edit --- </syntaxhighlight> <br> ==== ツール制御の用途 ==== ツールアクセスの制御は、以下に示す用途で使用する。<br> * セキュリティ *: 危険なツールへのアクセスを制限 * パフォーマンス *: 不要なツールの使用を防ぐ * 一貫性 *: 特定のツールのみを使用するワークフローを強制 <br> 例を以下に示す。<br> * 読み取り専用レビュースキル *: <u>Read</u>、<u>Grep</u>、<u>Glob</u> のみを許可 * テスト実行スキル *: <u>Bash</u> のみを許可 * ドキュメント作成スキル *: <u>Write</u>、<u>Read</u> のみを許可 <br><br> == 実用例 == ==== 例1 : コミット前テスト実行スキル ==== 変更をコミットする前にテストを実行するスキルの例を以下に示す。<br> <br> <syntaxhighlight lang="md"> --- name: commit-with-tests description: テストを実行してから変更をコミットする model: claude-sonnet-4-5-20250929 temperature: 0.3 --- # コミット前テスト実行スキル このスキルは、以下のステップを実行します: 1. 現在の変更状況を確認 2. テストを実行 3. テストが成功した場合のみコミット 4. テストが失敗した場合はエラーを報告 ## 実行手順 1. `git status` を実行して変更を確認 2. `npm test` または適切なテストコマンドを実行 3. テストが成功した場合: - `git add .` で変更をステージング - `git commit` でコミット 4. テストが失敗した場合: - エラーメッセージを表示 - コミットを中止 ## 注意事項 - テストが失敗した場合は、コミットを実行しないこと - コミットメッセージは、変更内容に基づいて適切に生成すること </syntaxhighlight> <br> ==== 例2 : コードレビュースキル ==== ファイルを読み取り専用でレビューするスキルの例を以下に示す。<br> <br> <syntaxhighlight lang="md"> --- name: review-code description: コードレビューを実行する model: claude-sonnet-4-5-20250929 temperature: 0.2 allowedTools: - Read - Grep - Glob --- # コードレビュースキル このスキルは、指定されたファイルのコードレビューを実行します。 ## レビュー観点 以下の観点でコードをレビューしてください: 1. コーディング規約への準拠 2. バグの可能性 3. パフォーマンスの問題 4. セキュリティの脆弱性 5. 可読性と保守性 ## 実行手順 1. 引数で指定されたファイルを読み込む 2. 上記の観点でレビューを実行 3. 問題点と改善提案をリスト形式で出力 ## 出力形式 レビュー結果は、以下の形式で出力してください: ### 問題点 - [重要度] 問題の説明 (行番号) ### 改善提案 - 提案内容 ## 注意事項 - ファイルを変更しないこと (読み取り専用) - 具体的な行番号を示すこと - 建設的なフィードバックを提供すること </syntaxhighlight> <br> ==== 例3 : ドキュメント生成スキル ==== プロジェクトのドキュメントを自動生成するスキルの例を以下に示す。<br> <br> <syntaxhighlight lang="md"> --- name: generate-docs description: プロジェクトのドキュメントを生成する model: claude-sonnet-4-5-20250929 temperature: 0.4 allowedTools: - Read - Write - Grep - Glob --- # ドキュメント生成スキル このスキルは、プロジェクトのソースコードを解析し、自動的にドキュメントを生成します。 ## 実行手順 1. プロジェクトのソースファイルを検索 2. 各ファイルの内容を解析 3. 関数、クラス、モジュールの説明を抽出 4. Markdown形式のドキュメントを生成 5. docs/ディレクトリに保存 ## ドキュメント構成 生成するドキュメントには、以下の内容を含めてください: - プロジェクト概要 - ディレクトリ構造 - 主要な関数とクラスの説明 - 使用例 - APIリファレンス ## 出力先 - ドキュメントは `docs/` ディレクトリに保存 - ファイル名は `API.md`、`GUIDE.md` など ## 注意事項 - 既存のドキュメントを上書きする前に確認すること - コメントが少ないファイルは、コードから推測してドキュメントを生成すること </syntaxhighlight> <br><br> == スキルの配置場所 == SKILLファイルは、特定のディレクトリ構造に従って配置する。<br> <br> 基本的なディレクトリ構造を以下に示す。<br> .claude/ ├── skills/ │ ├── commit-with-tests/ │ │ └── SKILL.md │ ├── review-code/ │ │ └── SKILL.md │ └── generate-docs/ │ └── SKILL.md └── CLAUDE.md <br> 各スキルは、独立したディレクトリに配置する。<br> ディレクトリ名は、スキル名と一致させることを推奨する。<br> <br> ==== プロジェクトレベルのスキル ==== プロジェクト固有のスキルは、<u>.claude/skills/</u> ディレクトリに配置する。<br> .claude/skills/スキル名/SKILL.md <br> これらのスキルは、プロジェクト内でのみ利用可能である。<br> <br> ==== ユーザレベルのスキル ==== 全プロジェクトで共有するスキルは、<u>~/.claude/skills/</u> ディレクトリに配置する。<br> ~/.claude/skills/スキル名/SKILL.md <br> これらのスキルは、全てのプロジェクトで利用可能である。<br> <br><br> == スキルの管理 == ==== スキルの一覧表示 ==== 利用可能なスキルを確認するには、Claude Codeのヘルプを参照する。<br> <br> # スキル一覧の表示 : /help <br> ヘルプには、利用可能なスキルとその説明が表示される。<br> <br> ==== スキルの更新 ==== スキルを更新するには、<code>SKILL.md</code>ファイルを編集する。<br> <br> 更新手順を以下に示す。<br> # <u>SKILL.md</u> ファイルを開く。 # YAMLフロントマターまたはMarkdown指示を編集する。 # ファイルを保存する。 # Claude Codeセッションを再起動して反映を確認する。 <br> スキルは、セッション開始時に自動的に読み込まれる。<br> <br> ==== スキルの削除 ==== スキルを削除するには、スキルディレクトリを削除する。<br> <br> # スキルの削除 : rm -rf .claude/skills/スキル名 <br> 削除後、Claude Codeセッションを再起動すると、スキルは利用できなくなる。<br> <br><br> == 高度な機能 == ==== モデルの指定 ==== スキルごとに使用するモデルを指定できる。<br> <br> 以下の例では、このスキルはOpus 4.5モデルを使用し、温度を0.8に設定している。<br> 創造的なタスクには高い温度が適している。<br> <br> <syntaxhighlight lang="md"> --- name: creative-writing description: 創造的な文章を生成する model: claude-opus-4-5-20251101 temperature: 0.8 --- </syntaxhighlight> <br> ==== 温度の調整 ==== <u>temperature</u> フィールドを使用することにより、モデルの創造性を調整できる。<br> <br> 温度の目安を以下に示す。<br> * 0.0 - 0.3 *: 決定論的で一貫性のある出力 (コードレビュー、テスト実行等) * 0.4 - 0.6 *: バランスの取れた出力 (ドキュメント生成、リファクタリング等) * 0.7 - 1.0 *: 創造的で多様な出力 (アイデア生成、文章作成等) <br> 温度の設定例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: code-review description: 厳密なコードレビュー temperature: 0.2 --- </syntaxhighlight> <br> <syntaxhighlight lang="md"> --- name: brainstorm description: アイデアをブレインストーミング temperature: 0.9 --- </syntaxhighlight> <br> ==== 複数ファイルのスキル ==== スキルディレクトリ内に、追加のファイルを配置することもできる。<br> <br> .claude/skills/my-skill/ ├── SKILL.md ├── template.md └── config.json <br> これらのファイルは、スキル内で参照できる。<br> <br> Markdown指示内での参照例を以下に示す。<br> <syntaxhighlight lang="md"> --- name: generate-report description: レポートを生成する --- # レポート生成スキル .claude/skills/generate-report/template.md を読み込み、そのテンプレートを使用してレポートを生成してください。 </syntaxhighlight> <br><br> == ベストプラクティス == ==== 明確な命名 ==== スキル名は、スキルの目的を明確に示す名前を使用する。<br> <br> スキル名は、kebab-caseで記述することを推奨する。<br> <br> <center> {| class="wikitable" |+ スキル命名の例 ! 良い例 !! 悪い例 |- | commit-with-tests || ct |- | review-code || review |- | generate-docs || docs |} </center> <br> ==== 詳細な説明 ==== <u>description</u> フィールドには、スキルの目的を明確に記述する。<br> <br> 具体的な説明を記述することにより、Claudeがスキルを適切に呼び出せる。<br> <br> <center> {| class="wikitable" |+ 説明の比較 ! 抽象的な説明 !! 具体的な説明 |- | コードをレビューする || 指定されたファイルのコーディング規約、バグ、パフォーマンスをレビューする |- | テストを実行する || 全てのユニットテストを実行し、失敗した場合はエラーを報告する |- | ファイルを作成する || 指定された名前と内容でファイルを作成し、適切なディレクトリに保存する |} </center> <br> ==== ステップバイステップの指示 ==== Markdown指示には、実行ステップを明確に記述する。<br> <br> <syntaxhighlight lang="md"> ## 実行手順 1. ファイルを読み込む 2. 内容を解析する 3. 問題点を特定する 4. 改善提案を生成する 5. 結果を出力する </syntaxhighlight> <br> 明確なステップを示すことにより、Claudeは正確にスキルを実行できる。<br> <br> ==== エラーハンドリング ==== スキルには、エラー時の動作を明記する。<br> <br> <syntaxhighlight lang="md"> ## エラーハンドリング 以下の場合はエラーを報告してください: - ファイルが存在しない場合 - ファイルの読み取り権限がない場合 - テストが失敗した場合 エラーメッセージには、原因と対処法を含めてください。 </syntaxhighlight> <br> 適切なエラーハンドリングにより、ユーザは問題を迅速に解決できる。<br> <br> ==== ツール制限の適切な使用 ==== スキルの目的に応じて、適切にツールを制限する。<br> <br> ツール制限の例を以下に示す。<br> * 読み取り専用スキル *: <u>allowedTools: [Read, Grep, Glob]</u> * 書き込み専用スキル *: <u>allowedTools: [Write]</u> * コマンド実行スキル *: <u>allowedTools: [Bash]</u> <br> 不要なツールへのアクセスを制限することにより、セキュリティとパフォーマンスが向上する。<br> <br><br> == トラブルシューティング == ==== スキルが認識されない場合 ==== ===== ディレクトリ構造を確認 ===== スキルが正しいディレクトリに配置されているか確認する。<br> <br> 正しい配置場所を以下に示す。<br> .claude/skills/スキル名/SKILL.md <br> ファイル名は必ず <u>SKILL.md</u> とする。<br> <br> ===== YAMLフロントマターを確認 ===== <code>name</code>と<code>description</code>フィールドが正しく記述されているか確認する。<br> <br> <syntaxhighlight lang="md"> --- name: my-skill description: スキルの説明 --- </syntaxhighlight> <br> YAMLの構文エラーがある場合、スキルは認識されない。<br> <br> ===== セッションを再起動 ===== スキルを追加または変更した後、Claude Codeセッションを再起動する。<br> <br> # セッションの再起動 : /exit claude <br> スキルは、セッション開始時に読み込まれる。<br> <br> ==== スキルが正しく動作しない場合 ==== ===== Markdown指示を見直す ===== Markdown指示が明確で具体的であるか確認する。<br> <br> 不明瞭な指示の例を以下に示す。<br> # 悪い例 : ファイルをチェックして問題があれば報告する <br> 明確な指示の例を以下に示す。<br> # 良い例 : 1. 指定されたファイルを読み込む 2. コーディング規約に違反していないか確認する 3. 違反がある場合は、行番号と問題点を報告する <br> ===== ツール制限を確認 ===== スキルが必要なツールにアクセスできるか確認する。<br> <br> 例を以下に示す。<br> * ファイルを読み込む必要がある場合 *: <u>allowedTools</u> に <u>Read</u> が含まれているか確認 * コマンドを実行する必要がある場合 *: <u>allowedTools</u> に <u>Bash</u> が含まれているか確認 <br> ===== モデルと温度を調整 ===== スキルの性質に応じて、適切なモデルと温度を設定する。<br> <br> 設定の目安を以下に示す。<br> * 決定論的なタスク (テスト実行、コミット等) *: <u>temperature: 0.2</u> * 創造的なタスク (アイデア生成、文章作成等) *: <u>temperature: 0.8</u> <br><br> == 関連機能 == ==== サブエージェントとの違い ==== スキルとサブエージェントは、異なる目的で使用される。<br> <br> スキルは軽量で高速、サブエージェントは独立性と並列性に優れている。<br> <br> <center> {| class="wikitable" |+ スキルとサブエージェントの比較 ! 項目 !! スキル !! サブエージェント |- | 目的 || 特定のタスクやワークフローの実行 || 独立したコンテキストでの複雑な作業 |- | 実行方法 || スラッシュコマンド || 自動呼び出しまたは手動呼び出し |- | コンテキスト || 親エージェントと共有 || 独立したコンテキストウィンドウ |- | モデル || 任意で指定可能 || 定義ファイルで指定 |- | 用途 || 頻繁に実行する操作の標準化 || 大規模な作業の並列実行 |} </center> <br> ==== CLAUDE.mdとの連携 ==== SKILLファイルは、CLAUDE.mdの内容を参照できる。<br> <br> 例を以下に示す。<br> * CLAUDE.mdでコーディング規約を定義 * スキルがその規約を参照してコードレビューを実行 <br> この連携により、プロジェクト固有のルールをスキルに適用できる。<br> <br><br> == 参考リンク == * [https://code.claude.com/docs/en/skills Claude Code公式ドキュメント - Skills] * [https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering Anthropic - Prompt Engineering] <br><br> {{#seo: |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Claude Code,SKILL,Skills,Workflow,AI,Anthropic,Development,Programming,SUSE,Linux,Automation,Command |description={{PAGENAME}} - Claude CodeのSKILLファイルに関する包括的なガイド |image=/resources/assets/MochiuLogo_Single_Blue.png }} __FORCETOC__ [[カテゴリ:設定]]
Claude Codeの設定 - SKILL
に戻る。
案内
メインページ
最近の更新
おまかせ表示
MediaWiki についてのヘルプ
ツール
リンク元
関連ページの更新状況
特別ページ
ページ情報
We ask for
Donations
Collapse