検証スキル
プロジェクトが大きくなるにつれて、同じ作業が何度も繰り返されていることに気づき始めます。スキルが繰り返し作業を自動化する良い方法であることはすでにご存じでしょう。このレッスンでは、スキルが特に得意とする具体的な仕事を1つ取り上げます。それは、自分自身の作業を検証することです。最初に作るべきスキルが1つあるとすれば、これがそれです。
検証スキルを最初に作るべき理由
普段Claudeの作業をどのように確認しているか考えてみてください。何かのリファクタリングを依頼し、完了したら、自分でダブルチェックすることを覚えておかなければなりません。テストを実行するよう頼むかもしれません。自分で差分を読むかもしれません。問題は、その確認作業があなたが「確認を頼むのを忘れないこと」に依存している点です。一度でもその手順を飛ばせば、不具合のあるコードがすり抜けてしまいます。
検証スキルはその依存関係を取り除きます。その仕組みはこうです。Claudeに何かのリファクタリングを依頼します。完了すると、その変更がスキルの記述内容に一致するため、スキルが自動的に発動します。そこから先は次のことを行います。
- テストスイートを実行する。
- 差分を読む。
- テストを通すためだけに弱められていないかを確認する。
- 証拠を添えて、合格か不合格かを報告する。
この一連の流れは、あなたが頼まなくても実行されます。スキルに書かれた記述がトリガーとなり、一度発動すれば毎回同じ手順をたどります。
この連鎖の最後のチェックに注目してください。テストを実行して緑色になるのを見るだけでは不十分です。テストは、何があっても通るようにこっそり緩められてしまうことがあります。そのため、スキルは差分を読み、テストが弱められていないことを確認します。「完了」とは、差分を読んだだけで「コードは正しそうだ」ということではありません。完了とは、ゲートが実行され、その結果が観察され、明示的に述べられていることです。
この同じ形は、チームが繰り返すあらゆる手順に当てはまります。リリースチェックリスト。マイグレーションの手順。PR前のチェック。経験則としては、同じ複数ステップの指示を2回タイプしたなら、それはスキルだということです。
スキルフォルダは指示以上のものを保持できる
スキルは単一のSKILL.mdファイルだけではありません。その周りのフォルダには他のものも入れられます。これこそが、スキルを検証に役立てる理由です。
- 詳細な資料は
SKILL.mdの隣にreference.mdとして置き、SKILL.mdからそこへリンクします。Claudeはその深さが必要なときだけそれを読みます。メインファイルは短いままです。 - スクリプトもフォルダに入れます。Claudeはその内容をコンテキストに読み込むのではなく、実行します。つまり、スキルはすべてのゲートを実行する
check.shのような、自前のツールを持つことができます。
要点はこうです。SKILL.md自体は軽量に保ちましょう。重い資料(長い説明や実行可能なスクリプト)はサイドファイルに押し出します。軽量なファイルは何をすべきかを記述します。サイドファイルは深い内容とツールを保持します。
どの指示の置き場がどのルールを担うか
ここまでで、指示を置く場所が3つ出てきました。混同しやすいので、整理しておきましょう。
常に適用される慣習、たとえば命名規則やファイルの置き場所といったものは、CLAUDE.mdファイルに属します。特定の種類のタスクに紐づく手順や参考資料は、スキルに属します。
3つ目のケースがあります。Claudeが絶対に飛ばしてはならないルールは、上記のどちらでもなく、フックに属します。なぜなら、CLAUDE.mdとスキルはどちらもClaudeが従う指示であるのに対し、フックは実際に実行されるコードだからです。そのルールを飛ばすことが許容できないのであれば、指示に従うかどうかに委ねてはいけません。
まとめ
スキルとは、中にSKILL.mdが入ったフォルダです。名前、発動のきっかけとなる記述、そして手順そのものから成ります。スキルが必要になるまでは記述だけがコンテキストに読み込まれるため、繰り返す手順をすべてパッケージ化してもコストはほとんどかかりません。
まずは検証から始めましょう。スキルを作り、プロジェクトの.claude/skillsにチェックインすれば、チーム全体が同じ動きを受け継ぎます。誰の作業も同じ方法で、自動的にチェックされるようになり、誰かが確認を頼むのを覚えておく必要はなくなります。