記事一覧スパルタClaude Code塾AI研修法人研修導入支援研修プランよくある質問
使い方ガイドClaude Code研究所 オリジナル解説

Claude Codeのverifyスキルとは?コミット直前に本当に呼ばれるか54回実測|書き方と公式チームの検証術

Claude Codeはverifyという名前のスキルをコミット直前に実行するよう指示されます。54回実測すると、Opus 5.5は6回中6回コミット直前に呼び、名前を変えるとSkillツールでは3回中0回でした。書き方も解説します。

Claude Codeのverifyスキルとは?コミット直前に本当に呼ばれるか54回実測|書き方と公式チームの検証術

この記事の結論

  • Claude Code(v2.1.286以降)は、verifyかsimplifyという名前のスキルがセッション開始時にあると、コミットの直前にそのスキルを実行するよう指示されます。公式ドキュメントとAnthropicの11月16日の公式ブログが説明しています。
  • 当研究所がv2.1.326で試すと、Opus 5.5は6回中6回、編集を終えた後・コミットの直前にverifyスキルを呼びました。中身が同じで名前だけcheck-reportに変えると、Skillツールでのコミット直前の呼び出しは3回中0回でした。
  • Sonnet 5.5はスキルの名前に関係なく、作業の最初にスキルを呼びました(verify 6回中5回、check-report 3回中3回)。ただし中身の確認自体は、どの回もコミット前に済ませていました。
  • サンプルデータと実行方法がリポジトリにある場合は、指示が無くても36回すべてでテストと実データでの実行を済ませてからコミットしました。差が出たのは実データがリポジトリの外にある場合で、場所と手順を書いておくと12回すべてが実データで確かめてからコミットしました。
  • verifyスキルには、Claudeがリポジトリから推測できないこと(実データの置き場所・実行コマンド・合否の基準)を書くと効果があります。今回の作業ではCLAUDE.mdに同じ文を書いても確認は行われ、ミスを防いだ事例は出ていません。

こんにちは、Claude Code研究所 技術ブログ担当です。Anthropicが11月16日に公開した公式ブログで、Claude Codeチームは「verifyという名前のスキルを作れば、Claudeはコミットの前にそれを使う」と書いていました。本当にそうなるのか、気になりますよね。そこでClaude Code(v2.1.326)で、スキルの置き方・名前・モデルを変えて54回コミットまで走らせ、いつ呼ばれ、何を確かめたかを数えました。verifyスキルに書くべき中身と、公式チームの検証の考え方もあわせて紹介します。

目次

  1. Claude Codeのverifyスキルとは?
  2. verifyスキルはコミットの直前に呼ばれた?
  3. スキルが無くても、Claudeは確かめていた?
  4. 実データがリポジトリの外にあると何が変わる?
  5. verifyスキルには何を書けばいい?
  6. Claude Codeチームは検証をどう考えている?
  7. 検証の方法と限界
  8. まとめ
  9. よくある質問
  10. 参考資料・出典

Claude Codeのverifyスキルとは?

verifyスキルは、変更したアプリを実際に動かして、意図どおりかを確かめる手順を書いたスキルです。Claude Code v2.1.286以降は、verifyという名前のスキルがセッション開始時にあると、コミットの直前にそれを実行するようClaudeに指示されます。

公式ドキュメントによると、Claude Codeには同梱の /verify があり、テストや型チェックに頼らずアプリを起動して変更を確かめます。うまくいった手順は .claude/skills/verify/SKILL.md に記録され、リポジトリ直下に置いたものは同梱版の代わりに使われます。

コミット直前の指示が付くのは、次の条件がそろったときです。

  • 名前:verify か simplify(同梱の/verify、プラグインのスキル、claude.aiのアカウントのスキルは対象外)
  • 場所:プロジェクト(.claude/skills/)・個人・企業・追加ディレクトリのスキル、または .claude/commands/ の同名ファイル
  • 呼び出し:Claudeが呼べること(disable-model-invocation: true を付けると外れる)
  • Gitの指示:設定の includeGitInstructions を切っていないこと。ドキュメントとテストだけの変更は対象外

11月16日の公式ブログ(Addy Osmani氏)は、この仕組みをチームの基本として紹介しています。Claude Codeチームではコードの約9割をClaudeが書き、レビューしているそうです。検証ループの全体像(Stop hookや/goal)は、当研究所の検証ループの解説記事にまとめています。この記事では、verifyスキルが本当にコミット直前に呼ばれるかに絞って測りました。

verifyスキルはコミットの直前に呼ばれた?

Opus 5.5は、verifyスキルを6回中6回、編集を終えた後・コミットの直前に呼びました。中身が同じで名前だけcheck-reportにすると、Skillツールでの呼び出しは3回中0回でした。Sonnet 5.5は名前に関係なく、作業の最初にスキルを呼びました。

題材は、会計ソフトから書き出した経費明細CSV(30行)から月次レポートを作る、小さなPythonのツールです。「税率別(10%と軽減8%)の税込合計を追加して、終わったらコミットして」と頼みました。確認の手順(単体テスト・実データでの実行・数字の照合の3行)は同じ文面にして、置き方だけを変えています。

置き方Opus 5.5Sonnet 5.5
.claude/skills/verify/SKILL.md6/6 コミット直前5/6 作業の最初(1回は呼ばず)
同じ中身で名前だけ check-report0/33/3 作業の最初
verify に disable-model-invocation: true0/30/3

※Skillツールでスキルを呼んだ回数とタイミング。verifyの6回はデータがリポジトリ内の3回と外の3回の合計。v2.1.326、claude -p、各3回

名前を変えただけで、同じ実験の中でOpusのコミット直前の呼び出しが3/3から0/3になりました…! Opusは編集を終えると、コミットの前に毎回verifyを呼んでいます。ドキュメントのとおり、verifyという名前にだけコミット直前の指示が付いているからだと考えられます。ただしOpusは、check-reportとdisable-model-invocationの回でも SKILL.md を自分で開いて読んでいました(disable-model-invocationの回はSonnetも同じ)。0/3は「Skillツールで呼ばなかった」という意味で、中身を無視したわけではありません。

Sonnetの動きは少し違いました。ファイルの編集に入る前、最初の1〜2手でスキルを呼んでいます。名前がcheck-reportでも同じでした。「手順を先に読んでから作業する」使い方で、コミット直前に呼ぶわけではないんです。それでも、書かれた確認はどの回もコミット前に済ませていました。

スキルが無くても、Claudeは確かめていた?

サンプルデータと実行方法がリポジトリにある場合は、確かめていました。指示なしを含む6通り36回すべてで、Claudeはコミット前に単体テストと実データでの実行を済ませています。

正直、ここは予想外でした。指示なしの回は単体テストだけで済ませると思っていたんです。実際には、編集用のスクリプトの最後で python -m unittest と python -m keihi report samples/… を続けて流し、その出力に実データ30行を読んだ表示が出た後で、コミットしていました。README に実行コマンドがあり、samples/ に実データ形式のCSVがあったので、Claudeは自分で使い方を見つけられたわけです。

実はこのCSVには、税区分が空欄の明細が6件、「対象外」が1件入っています。単体テストだけなら見落とす罠のつもりでした。ところが試走の段階で、Claudeは最初にCSVを開いて空欄に気づき、正しく除外していました。コミットされた結果は、全回とも税率別の合計が正しかったです、、、つまり今回の作業では、verifyスキルがミスを防いだ場面は出ていません。

実データがリポジトリの外にあると何が変わる?

実データをリポジトリの外に置くと、差が出ました。指示が無いと、Sonnet 5.5は3回とも手を止めて質問し、Opus 5.5は3回とも実データを見ないままコミットしました。データの場所と確認手順を書いておくと、12回すべてが実データで確かめてからコミットしました。

個人情報を含む実データは、リポジトリに入れないのがふつうですよね。データがリポジトリにある実験では差が出なかったので、条件をこちらに変えて試しました、、、そこで、同じCSVをリポジトリの外のフォルダに移し、samples/ を無くして同じ依頼をしました。

置き方(実データはリポジトリの外)Opus 5.5Sonnet 5.5
指示なし3/3 コミット(実データでは0回も実行せず)0/3 コミット(3回とも質問して停止)
CLAUDE.md にデータの場所と確認手順3/3 実データで実行してコミット3/3 実データで実行してコミット
verify スキルに同じ内容3/3 実データで実行してコミット3/3 実データで実行してコミット

※「実データで実行」は、コミット前のツール出力に実データの30行を読んだ表示があった回。v2.1.326、claude -p、各3回

指示の無いSonnetは、3回とも同じような質問を返してきました。CSVの税率の列名と書き方が分からないので、推測で作ると経理の集計がずれても気づきにくい、というものです。慎重で誠実な止まり方だと感じました!

一方のOpusは、税率の列名と表記を推測してコードを書きました(3回中2回は列名を「税区分」と決め打ち、1回は候補の列名を複数用意)。自分で作った小さなCSVで動かしてコミットしています。推測が当たって、結果は3回とも正しかったです。ただ、それは実データで確かめた結果ではありません…。最終報告で、実際のCSVの列名や税区分の値を経理担当に確かめるよう書き添えていたのは、Opus自身もそこを分かっていたからだと思います。

そしてもう1つ。CLAUDE.mdに同じ手順を書いた場合も、verifyスキルと同じく6/6でした。今回効いたのは、スキルという形そのものより「データがどこにあり、何を実行すればいいか」が書いてあることでした。

verifyスキルには何を書けばいい?

Claudeがリポジトリから推測できないことを書きます。実データや検証用データの置き場所、起動と実行のコマンド、何が出れば合格かの基準です。名前は verify にし、disable-model-invocation は付けません。

今回の実験で使ったものとほぼ同じ形です。リポジトリ直下の .claude/skills/verify/SKILL.md に置きます。

.claude/skills/verify/SKILL.md
---
name: verify
description: keihi の変更を、実データで動かして確かめる手順
---

1. python -m unittest を実行する
2. python -m keihi report /path/to/data/2026-10_経費.csv -o /tmp/verify_report.html
   を実行し、エラーなく終わることを確かめる
   (経理から預かった10月の実データ。個人情報を含むのでリポジトリには入れない)
3. 出力したHTMLを開き、変更した箇所の数字が
   明細から手で計算した値と合っていることを確かめる

書くときのコツは3つです。

  • 場所を書く:リポジトリの外に実データがあると、場所を知らないSonnetは質問して止まり、Opusは推測で進めました。今回いちばん差が出たのはここでした
  • 合格の基準を書く:「エラーなく終わる」「合計が元データと一致する」のように、合否が分かる形にします。エラーにならずに数字だけがずれるミスは、基準が無いと見落としやすいはずです(今回の実験では、ずれたコミットは出ませんでした)
  • 名前は verify:コミット直前に実行させたいなら、この名前にします。中身を同じにしてもcheck-reportでは、OpusはSkillツールでコミット直前に呼びませんでした

士業やバックオフィスの業務に置き換えると、たとえば「申告書の様式を生成したら、この顧問先のテストデータで出力し、合計欄が元帳の合計と一致するか確かめる」です。人が毎回やっている確認を、そのまま手順として書けばいいんです。ここは試す価値があります!プロジェクトのルールを書くCLAUDE.mdとの使い分けは、CLAUDE.mdとスキルの使い分けの記事も参考になります。

Claude Codeチームは検証をどう考えている?

公式ブログによると、Claude Codeチームはテストよりも「変更を実際に動かすこと」を重視しています。そのうえで、テストは失敗を見つけたら人を呼ぶ仕組みとして使い、確認そのものを変更から守る工夫を重ねています。

読んでいて面白かったのは、検証を「仕組みとして運用する」発想です。要点を抜き出します。

  • 効くテストは3種類:実際の操作の流れをたどるE2Eテスト、「どんな入力でも残高はマイナスにならない」のような性質を大量の入力で試すプロパティテスト、移行の前後で同じ入力の結果を比べる差分テスト
  • 3回直せなければ人を呼ぶ:Claudeがチェックを走らせて直し、3回やっても失敗するときだけ人が入る
  • 差分から発火するチェックリスト:39項目のうち、変更の差分に当てはまる項目(ふつう3〜10項目)だけをClaudeが確認する
  • 変更が自分の検査を書き換えられない:レビューの方針を書くREVIEW.mdは、プルリクエストではなくベースブランチから読む
  • 新しい関門は「観察モード」から:/code-reviewか/verifyを通していないコミットを止める仕組みを、off・observe・enforceの3段階で入れる。2回止めたら3回目は通し、Claudeが詰まらないようにしている
  • 不安定なテストは逃がさない:スキップ、待ち時間の追加、通るまでの再実行は禁止。原因が分からなければ、理由を書いてテストを消す

「2回止めたら3回目は通す」は、ブログの言葉を借りれば、Claude Codeが完璧ではないからだそうです。こうした現実的な割り切りまで公開されているのは、運用を考える側としてありがたいです!

検証の方法と限界

検証はClaude Code v2.1.326、macOS、Ultraプランのログインで、claude -p(非対話モード)を使って行いました。

  • 素材:経費明細CSV(cp932、30行。税区分が空欄6件・対象外1件を含む)から月次レポートを作るPythonのツールと単体テスト3件。依頼は「税率別(10%・軽減8%)の税込合計を追加してコミット」の1種類です
  • 条件:データをリポジトリに置く場合が6通り(指示なし/CLAUDE.mdに「単体テストを実行」/CLAUDE.mdに確認手順/verifyスキル/同じ中身のcheck-reportスキル/disable-model-invocation付きverify)、リポジトリの外に置く場合が3通り(指示なし/CLAUDE.md/verifyスキル)
  • 実行:Sonnet 5.5とOpus 5.5で各3回、計54回。effortは既定、権限は acceptEdits+ツールの許可リストです
  • 採点:スキルの呼び出しはSkillツールの記録で、確認の実行はコミット前のツール出力(単体テストの実行件数と、実データ30行を読んだ表示)で判定しました。正しさは、最後のコミットの状態を取り出して実データで実行し、税率別の合計を照合しました
  • 試走:最初の3回(Sonnet)で、Claudeが自分でCSVを読んで罠に気づき全回正解したため、比べる軸を「いつ・何を確かめたか」と「データがリポジトリの外にある場合」に変えました(試走は集計から除外)

限界もあります。作業は小さなツールの1種類で、各3回です。ミスを含むコミットは1回も無く、verifyスキルが誤りを防ぐかは確かめられていません。名前の比較もcheck-reportの1つだけです。対話モード、Fable 5.2・Haiku 5.5、大きなリポジトリでの動きは測っていません。

負荷や障害まで含めた本番前の点検をClaude Codeに任せる場合は、Anthropicのchaos loopを手元で49回再現した検証もどうぞ。頼み方より、CLAUDE.mdに書いた守る条件で結果が分かれました。

まとめ

verifyという名前のスキルを置くと、Opus 5.5はコミットの直前にそれを呼びました。Sonnet 5.5は作業の最初に読み込み、確認はコミット前に済ませました。効果の中心は「Claudeが知らないデータの場所と確認手順を書いておくこと」で、今回はCLAUDE.mdに書いても同じでした。

この記事のまとめ

  • verify(またはsimplify)という名前のスキルがあると、Claude Codeはコミット直前の実行を指示する(v2.1.286以降)
  • Opus 5.5はverifyを6/6でコミット直前に呼んだ。同じ中身のcheck-reportでは0/3(ただしファイルは読んでいた)
  • Sonnet 5.5は名前に関係なく作業の最初にスキルを呼んだ(verify 5/6、check-report 3/3)
  • データと実行方法がリポジトリにあれば、指示なしでも36回すべてが実データで確かめてからコミットした
  • 実データがリポジトリの外だと、指示なしのSonnetは質問して停止、Opusは実データを見ずにコミット。場所と手順を書けば12/12が実データで確かめた
Claude Code研究所の研修

記事で紹介した設定を、自社の業務に合わせて組み上げる。

CLAUDE.mdによるプロジェクト規約の設定から、業務に合わせたオリジナルskillsの作成まで、一社ごとにヒアリングした業務を題材に対面で進めます。受講者限定のオリジナルskillsとプロンプトテンプレート集もお渡しします。

  • 一社ごとに業務をヒアリングして設計
  • 実際の業務データでハンズオン
  • スパルタ以上は全額返金保証
  • 受講法人数100社超
30分の無料相談を予約するClaude Code研修の内容を見る

オンライン30分・無料。フォームは入力1分で、2営業日以内にご連絡します。

よくある質問

Claude Codeのverifyスキルとは何ですか?

変更したアプリを実際に起動して、意図どおりに動くかを確かめるためのスキルです。Claude Codeには同梱の/verifyがあり、手順を記録すると.claude/skills/verify/SKILL.mdとしてリポジトリに保存されます。リポジトリ直下に記録したverifyスキルは同梱版の代わりに使われ、v2.1.286以降はコミットの直前に実行するようClaudeに指示されます。

verifyスキルはコミットの前に自動で実行されますか?

セッション開始時にverifyという名前のスキルがあると、Claude Codeはコミットの直前にそれを実行するようClaudeに指示します(v2.1.286以降。ドキュメントとテストだけの変更は除く)。当研究所のv2.1.326での実測では、Opus 5.5は6回中6回コミット直前に呼びました。Sonnet 5.5は作業の最初に呼ぶことが多く、コミット直前ではありませんでした。

スキルの名前はverifyでないといけませんか?

コミット直前に実行させたいならverify(またはsimplify)にします。当研究所の実測では、中身が同じで名前だけcheck-reportにすると、Opus 5.5はSkillツールでの呼び出しが3回中0回でした。disable-model-invocation: trueを付けたverifyも同じく呼ばれません。同梱の/verifyやプラグインのスキルは、この指示の対象外です。

verifyスキルには何を書けばいいですか?

Claudeがリポジトリから推測できないことを書きます。実データや検証用データの置き場所、アプリの起動と実行のコマンド、何が出れば合格かの基準です。当研究所の実測では、実データがリポジトリの外にあると、指示の無いSonnet 5.5は手を止めて質問し、Opus 5.5は実データを見ないままコミットしました。場所と手順を書くと、両モデルとも実データで確かめてからコミットしました。

CLAUDE.mdに書くのとverifyスキルにするのは何が違いますか?

今回の作業では、同じ確認手順をCLAUDE.mdに書いた場合も、verifyスキルにした場合も、確認はコミット前に行われました。違いはタイミングの約束です。verifyという名前のスキルは、Claude Codeがコミット直前の実行を指示します。手順が長い場合や、複数のリポジトリで同じ確認を共有したい場合は、スキルにしておくと管理しやすくなります。

参考資料・出典

  1. 公式ブログ・記事How the Claude Code team thinks about verification
    Addy Osmani(Anthropic) / claude.dev Blog / 2026-11-16

    Claude Codeチームのコードの約9割をClaudeが書きレビューしていること、E2E・プロパティ・差分テスト、verifyスキル、3回失敗したら人を呼ぶ、39項目の信頼性チェックリスト、REVIEW.mdをベースブランチから読む、off/observe/enforceのコミットゲート

  2. 公式ドキュメントExtend Claude with skills(Run and verify your app/Run your checks before each commit)
    Anthropic / Claude Code Docs / 2026-11-17

    同梱の/run・/verify・/run-skill-generator、/verifyが.claude/skills/verify/SKILL.mdに手順を記録すること、verifyかsimplifyという名前のスキルがあるとコミット直前の実行を指示すること(v2.1.286以降)と、その条件(確認日)

  3. 公式ブログ・記事Building verification loops in Claude Code with skills
    Delba de Oliveira(Anthropic) / Claude / 2026-07-22

    検証ループの定義、/verifyスキルはビルド・実行・観察する、手作業の確認をスキルにする考え方

  4. スレッドClaudeDevs「Claude writes better code when it can verify its work.」
    ClaudeDevs(Anthropic) / X / 2026-11-17

    上記ブログの告知(2026年11月17日閲覧時点で約25.3万表示・いいね5,200・ブックマーク5,600)

  5. GitHubClaude Code v2.1.326
    Anthropic / GitHub / 2026-11-16

    検証に使ったバージョン

この記事をシェアするXでシェアnoteをフォロー
記事一覧に戻るトップページへ

Claude Codeを実務で活用したい方へ

一社ごとにカスタマイズする対面のClaude Code研修は「スパルタClaude Code塾」。経営者・士業・エンジニア・マーケター・営業職まで、業務をヒアリングしてカリキュラムを設計します。まずは30分の無料相談で、自動化プランと費用対効果をご確認ください。

最新の解説記事

関連記事