| name | prompt-verifier |
| description | Верификация и переписывание СУЩЕСТВУЮЩИХ инструкционных файлов (CLAUDE.md, AGENT.md, SKILL.md) против 7 правил форматирования. Использовать когда пользователь просит "проверить/исправить/проаудитить промт", "агент игнорирует правила", "отрефакторить инструкции", перед коммитом изменений в инструкционные файлы. НЕ для создания новых агентов — использовать agent-builder. |
| user-invocable | true |
| context | fork |
| agent | general-purpose |
Prompt Verifier
Верификация и адаптация инструкционных файлов (CLAUDE.md, AGENT.md, SKILL.md) под 7 правил форматирования. Выявляет нарушения и выдаёт улучшенную версию с пояснениями.
When to Use
- Перед коммитом нового или обновлённого CLAUDE.md / AGENT.md / SKILL.md
- Когда агент игнорирует написанные правила
- При рефакторинге инструкций (уменьшение объёма, повышение чёткости)
Arguments
/prompt-verifier [file_path] [mode] [rules...]
| Аргумент | Тип | По умолчанию | Описание |
|---|
file_path | строка (путь) | — | Путь к файлу (первый аргумент, если не начинается с verify/adapt/R) |
mode | verify | adapt | adapt | Режим работы |
rules... | R1–R7 | все 7 | Правила для проверки (пробелом) |
/prompt-verifier CLAUDE.md
/prompt-verifier docs/AGENT.md verify
/prompt-verifier .claude/settings.json adapt R1 R5
Если file_path не передан — запроси у пользователя путь к файлу.
How It Works
Step 1: Load Input
- Прочитай файл через
Read по переданному file_path.
- Определи режим:
verify (только отчёт) или adapt (отчёт + переписанный документ, по умолчанию).
- Определи список правил для проверки (
R1–R7; по умолчанию — все).
Step 2: Analyze Against 7 Rules
Проверь каждое правило:
| # | Правило | Критерий провала |
|---|
| R1 | Обоснование запретов | Запрет/ограничение без объяснения «почему» |
| R2 | Плоская иерархия заголовков | Использование h4/h5 (глубже 3 уровней) |
| R3 | Описательные имена файлов | Файлы с неинформативными именами (guide.md, notes.md, setup.sh) |
| R4 | Заголовки для разделов | Абзацы прозы без заголовков, конкурирующие инструкции без структуры |
| R5 | Команды в блоках кода | Команды/пути/инструменты в прозе, не в `backticks` или ```code``` |
| R6 | Стандартные имена разделов | Нестандартные названия вместо ## Testing, ## Commands, ## Structure |
| R7 | Выполнимые инструкции | Расплывчатые инструкции, не проходящие тест «выполни немедленно» |
Step 3: Report Violations
Для каждого нарушения укажи: правило (R1–R7), цитату проблемного фрагмента, последствие, конкретное исправление.
Итоговый score: количество выполненных правил из 7.
Step 4: Adapt (режим adapt)
Перепиши документ, применив все исправления:
- Сохрани смысл; сократи объём на -30%
- Добавь обоснование к запретам
- Замени inline-команды блоками кода
- Преобразуй описательные шаги в императивы
- Используй стандартные имена разделов (English)
Выведи JSON по схеме ## Output Format. Для режима adapt поле adapted_document — обязательно.
Output Format
verify mode
{
"verification": {
"score": "{{score: integer, min 0, max 7}}",
"rules_passed": ["{{rule_id: enum R1|R2|R3|R4|R5|R6|R7}}"],
"violations": [
{
"rule": "{{rule_id: enum R1|R2|R3|R4|R5|R6|R7}}",
"rule_name": "{{rule_name: string}}",
"severity": "{{severity: enum critical|warning|info}}",
"fragment": "{{fragment: string}}",
"consequence": "{{consequence: string}}",
"fix": "{{fix: string}}"
}
],
"summary": "{{summary: string}}"
}
}
adapt mode (дополнительно)
{
"verification": { "...": "...same as verify..." },
"adaptation": {
"adapted_document": "{{adapted_document: string}}",
"changes_made": ["{{change: string}}"],
"word_count_before": "{{word_count_before: integer}}",
"word_count_after": "{{word_count_after: integer}}",
"reduction_percent": "{{reduction_percent: integer}}"
}
}
Rules
- @rules:best-practices.md - Проектирование инструкций, типичные ловушки, советы по производительности
Examples
- @example:basic-claude-md.md - Верификация простого CLAUDE.md (3 нарушения, режим adapt)
- @example:agent-instructions.md - Верификация инструкций агента (режим verify)
- @example:skill-md-check.md - Проверка SKILL.md с нестандартными именами разделов
Templates
- @template:input.json - Входные данные для вызова скилла
- @template:output-verify.json - Структура выходных данных (verify mode)
- @template:output-adapt.json - Структура выходных данных (adapt mode)
Schemas
- @schema:input - Валидация входных данных
- @schema:output-verify - Валидация выходных данных (verify mode)
- @schema:output-adapt - Валидация выходных данных (adapt mode)
iwiki Integration
Этот скилл не вызывает context-awareness — проверяет домен iwiki (wiki_status) напрямую.
Query (в начале Step 2 — Analyze Against Rules)
IF iwiki MCP подключён AND wiki_status сообщает домен проекта (привязать через wiki_bind):
wiki_search(query='паттерны нарушений и best practices форматирования инструкций')
Использовать результат для обогащения Step 2:
- Если домен iwiki содержит задокументированные нарушения → добавить в анализ
- Если домен iwiki содержит принятые стандарты форматирования → учесть при adapt
- Если в домене iwiki нет данных → продолжить стандартный анализ по R1-R7
Record (после Step 4 — только в режиме adapt)
iwiki — embedding-граф документации в MCP-сервере (доменная модель); запись новой страницы через wiki_write_page (авто-переиндексация домена и авто-коммит базы).
IF wiki_status сообщает домен проекта AND mode == "adapt" AND violations_found > 0:
(опционально) author markdown → wiki_write_page(domain, slug, markdown, source) # авто-переиндексация
пример нарушения и его исправление (что и почему), ссылаясь на {verified_file_path}
Результат: примеры нарушений и исправлений попадают в домен iwiki —
переиспользуются как эталоны при следующих проверках документов.
Workflow Integration
Input Dependencies
- Путь к файлу (обязательно) или inline-текст
- Режим:
verify | adapt (default: adapt)
Output Consumers
- Пользователь → применяет адаптированный документ
git-workflow → коммит улучшенного файла- CI/CD → автоматическая проверка CLAUDE.md перед мержем
