Навички для агентів та підтримувачів

Цей розділ описує навички та процедури для агентів та підтримувачів, які використовуються під час підтримки сайту.

Ми використовуємо термін agent skill для позначення повторно використовуваних дій, написаних відповідно до agentskills.io, які можуть бути викликані агентами або виконані вручну підтримувачами. Ми називаємо maintainer skill (або процедуру підтримувача) набір кроків, які агент або підтримувач можуть виконати для досягнення конкретного завдання. Навички агентів визначені в .claude/skills/. Процедури підтримувачів визначені в цьому розділі.

Agent skills

Як зазначено вище, навички визначені в .claude/skills/, вони включають:

• /approve-registry-update [номер-pr-або-url]: допомога рецензентам у прийнятті рішення щодо обʼєднання PR з оновленням версій реєстру від otelbot; перевірка, чи це чисте оновлення, і після підтвердження — затвердження та додавання до черги злиття. Без аргументу обробляє відкриті PR з автоматичним оновленням реєстру.
• /draft-issue <опис-проблеми>: створення тікета GitHub в репозиторії opentelemetry.io відповідно до шаблонів, керівництва з внеску та таксономії міток.
• /refresh-refcache-pr-fix: отримання, перегляд та спроба виправити URL-адреси, що не повертають 2XX, у PR від otelbot (зазвичай otelbot/refcache-refresh, або гілка інтеграції spec/semconv, якщо вказано).
• /resolve-refcache-conflicts <необовʼязковий-номер-pr>: вирішення конфліктів злиття/перебазування static/refcache.json.
• /review-blog-post <шлях-до-блогу-або-номер-pr>: перевірка блогу OpenTelemetry на відповідність front matter, конвенціям контенту, стабільності посилань GitHub (gh-url-hash), орфографії та термінології OTel.
• /review-pull-request <номер-pr-або-url>: перевірка pull request на семантику перевірок CI, робочий процес CLA та міток затвердження, обробку refcache, правила локалізації та якість контенту.
• /update-i18n-drift-status [--locale locale,...] [--create-pr]: оновлення поля front matter drifted_from_default для локалізованого контенту, з опціональними аргументами для обмеження обробки певних локалей та автоматичного відкриття PR.
• /update-old-blog-ignores: розширити діапазон років старих публікацій у блозі, які не підлягають перевіркам на дотримання стилю та формату, а також виправити відповідні скрипти.
• /update-git-submodule <submodule>... <version|latest|HEAD>: оновлення одного або кількох підмодулів git до цільової версії.

Деякі чати агентів дозволяють викликати навичку, набравши /, а потім її назву.

Hooks

Разом із навичками агентів вище, hooks запускаються автоматично при певних подіях інструменту. Конфігурація знаходиться в .claude/hooks/hooks.json; джерело хуків знаходиться в scripts/validate/.

• Перевірка front matter блогу: хук PreToolUse на Write та Edit, який блокує зміни в content/en/blog/**/*.md, коли front matter відсутні обов’язкові поля, використовується неправильний формат дати або вводиться заголовок H1. Він застосовує ті ж конвенції, що й /review-blog-post під час запису, без очікування на перевірку. Джерело: scripts/validate/front-matter-check/. Чиста логіка знаходиться в index.mjs і покрита тестами в index.test.mjs у тій же теці (npm run test:local-tools для запуску).

Maintainer skills

Дивіться вміст розділу нижче.