なぜ skill か
チームはすでに、コーディングアシスタント向けにセキュリティルールをエージェント skill として管理しているかもしれません。カスタムエージェントはコードレビューで同じ skill に従えます。変更が必要とするときに skill を開き、参照ファイルを読み、各指摘が適用するルールを引用します。メインブランチで skill が変わると、設定を変えなくてもエージェントは新しいバージョンに従います。 例はマルチテナントのスケジューリング API で、すべてのクエリは呼び出し元のワークスペースにスコープされる必要があります。ステップ1 — リポジトリの skill
.claude/skills/tenant-isolation/SKILL.md
.claude/skills/tenant-isolation/references/tenant-tables.md
name は一致する必要があり、description は必須です。
ステップ2 — エージェントとしてインポートする
1
リポジトリの設定を開く
スコープピッカーでリポジトリを選び、What to review → Custom agents → New agent を開きます。
2
Import from repository
タブにデフォルトブランチで見つかった skills が表示されます。tenant-isolation をクリックします。
3
結果を確認する
エージェントはオフで作成され、名前は Tenant isolation reviewer、skill が紐付けられ、指示は次のとおりです。
ステップ3 — 指示を磨く
skill への参照は残し、指摘に必要な証拠を加えます。Instructions
ステップ4 — オプション:プラグイン
課題管理ツールがプラグインとしてインストールされていれば、Tools → Plugins でオンにします。提供されるのは読み取りツールだけです。プルリクエストの説明がチケットにリンクしていれば、エージェントはそれを読み、変更が求められた内容に合っているかを確認できます。ステップ5 — コメント
Save をクリックします。
ステップ6 — Try it
エンドポイントを追加するプルリクエストで Try it を実行します。確認すること:- Skills opened に
.claude/skills/tenant-isolationが表示され、エージェントが必要としたときはreferences/tenant-tables.mdも表示される。 - 保持された指摘が skill のルールを引用している:
- 破棄された指摘に理由が表示される。skill がカバーしない一般的なセキュリティの指摘は、エージェントの担当範囲外として破棄されます。ここではそれが望ましい動作です。
@kody -v tenant-isolation-reviewer とコメントします。
チェックリスト
-
SKILL.mdにフォルダー名と一致するnameとdescriptionがある - 参照ファイルは skill から最大 1 フォルダー下にある
- 指示に指摘に必要な証拠が書かれている
- 最小重大度がエージェントの望ましい発言量に合っている
- 既知の不備を含むプルリクエストで試した