エージェントとメンテナー向けのスキル

このセクションでは、サイトのメンテナンス時にエージェントとメンテナーが使用するスキルと手順について説明します。

エージェントスキルとは、エージェントが呼び出したりメンテナーが手動で実行したりできる、agentskills.io に準拠して記述された再利用可能なアクションを指します。 メンテナースキル（またはメンテナー手順）とは、エージェントやメンテナーが特定のタスクを達成するために従う一連の手順です。 エージェントスキルは .claude/skills/ で定義されています。 メンテナー手順はこのセクションで定義されています。

スキルと手順のステップでは、各アクションの意図を文章で記述します。 括弧内に記載されたコマンドはステップを実行するための提案であり、唯一の方法ではありません。 この規約が採用される前に記述されたスキルは、まだこれに従っていない可能性があります。

エージェントスキル

上記のとおり、スキルは .claude/skills/ で定義されています。 以下がそのリストです。

• /approve-registry-update [pr-number-or-url]: otelbot のレジストリバージョンバンプ PR をマージすべきかどうかの判断をレビュアーに支援します。 クリーンなバンプであることを検証し、確認後に承認してマージキューに追加します。 引数なしの場合、オープンなレジストリ自動更新 PR を処理します。
• /draft-issue <issue-description>: イシューテンプレート、コントリビューティングガイドライン、ラベル分類に従って opentelemetry.io リポジトリに GitHub イシューを下書きします。
• /refresh-link-cache-pr-fix: otelbot PR 上の非 2XX URL を取得、レビュー、修正を試みます（デフォルトではリンクチェックが失敗しているすべてのオープンな otelbot/* PR、または指示された特定のブランチ）。
• /resolve-link-cache-conflicts <optional-pr-number>: .lycheecache のマージ/リベースの競合を解決します。
• /review-blog-post <blog-post-path-or-pr-number>: OpenTelemetry のブログ投稿をフロントマター準拠、コンテンツ規約、GitHub リンクの安定性（gh-url-hash）、スペル、OTel 用語についてレビューします。
• /review-pull-request <pr-number-or-url>: プルリクエストを CI チェックのセマンティクス、CLA と承認ラベルのワークフロー、リンクキャッシュの処理、ロケールルール、コンテンツ品質についてレビューします。
• /setup-new-localization <kickoff-issue | lang-code>: 新しいウェブサイトのローカリゼーションをエンドツーエンドでセットアップします。 Hugo の言語ブロック、コンテンツマウント、cSpell ワードリスト、lang:<lang> ラベラー設定とラベル、locale-teams.yaml と CODEOWNERS の再生成、localization.md のエントリを含みます。
• /update-i18n-drift-status [--locale locale,...] [--create-pr]: ローカライズされたコンテンツの drifted_from_default フロントマターフィールドを更新します。 処理するロケールの制限や PR の自動作成のためのオプション引数があります。
• /update-old-blog-ignores: lint/format チェックおよび修正スクリプトから除外される古いブログ投稿の年範囲を更新します。
• /update-git-submodule <submodule>... <version|latest|HEAD>: 1つ以上の git サブモジュールをターゲットバージョンに更新します。

一部のエージェントチャットでは、/ に続けてスキル名を入力することでスキルを呼び出せます。

フック

上記のエージェントスキルに加えて、フックは特定のツールイベント時に自動的に実行されます。 設定は .claude/hooks/hooks.json にあり、フックのソースは scripts/validate/ 以下にあります。

• ブログのフロントマターチェック: Write と Edit に対する PreToolUse フックで、フロントマターに必須フィールドが欠けているか、日付形式が不正であるか、H1 見出しが導入されている場合に content/en/blog/**/*.md への変更をブロックします。 レビューを待たずに、/review-blog-post と同じ規約を書き込み時に適用します。 ソース: scripts/validate/front-matter-check/。 純粋なロジックは index.mjs にあり、同じフォルダの index.test.mjs でカバーされています（実行は npm run test:local-tools）。

メンテナースキル

以下のセクションインデックスを参照してください。