Skip to main content

なぜ 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 フォルダー下にある
  • 指示に指摘に必要な証拠が書かれている
  • 最小重大度がエージェントの望ましい発言量に合っている
  • 既知の不備を含むプルリクエストで試した
検出と予算については Skills & docs を参照してください。