BF project-analyzer-generate-doc
Генератор документации для многомодульных Java Maven проектов. Поддерживает сопоставление SQL MyBatis, анализ зависимостей Maven, генерирует иерархическую документацию от L3 (уровень файла) до L2 (уровень модуля) до L1 (уровень проекта). Функции включают мониторинг задач, автоматическую повторную попытку, возобновление с контрольной точки и проверки работоспособности.
машинный переводПоказать оригиналСкрыть оригинал«Java Maven multi-module project documentation generator. Supports MyBa…»
Java Maven multi-module project documentation generator. Supports MyBatis SQL mapping, Maven dependency analysis, generates L3(file-level) to L2(module-level) to L1(project-level) hierarchical docs. Features task monitoring, auto-retry, checkpoint resume, and health checks.
Генератор документации для многомодульных Java Maven проектов.
Как процесс F 41/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: references/l3-template.md, references/l2-template.md, references/l1-template.md
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 3
✓ Критических и высоких находок нет
Средние и низкие: 3
-
низкая Рискованное назначение
intent-offensive-securityCHANGELOG-v2.1.4.md:15Наступательная безопасность / двойное назначение (допустимо для авторизованного тестирования; проверьте назначение)- ❌ Removed all references to "elevated permissions" or privilege escalation
-
низкая Опасные команды
cmd-execpolicy-bypasspackage.json:22Запуск PowerShell с обходом execution policy (в кавычках — упоминание, а не команда)"generate-l3": "powershell -ExecutionPolicy Bypass -File scripts/gene…ps1",
в кавычках -
низкая Рискованное назначение
intent-offensive-securitySECURITY_FIXES.md:72Наступательная безопасность / двойное назначение (допустимо для авторизованного тестирования; проверьте назначение)**Rationale**: Privilege escalation attempts are security risks and outside the scope of documentation generation.
Просканировано файлов: 21. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - предупреждение
body-longтело SKILL.md ≈ 5238 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: references/l3-template.md - предупреждение
missing-refссылка на отсутствующий файл: references/l2-template.md - предупреждение
missing-refссылка на отсутствующий файл: references/l1-template.md
Процессный рейтинг: все десять параметров 41/100
- 0Инструменты и файлы. Не хватает 3 файла(ов): references/l3-template.md, references/l2-template.md, references/l1-template.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 70Стоимость исполнения. Тело инструкции 5238 токенов
- 100Шаги. Шагов: 55
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющих операций нет
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- low Разделов верхнего уровня: 14. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- -216 эмодзи в инструкциях: шум для модели
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 274 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 44 заголовков
- +3Пошаговые инструкции: 55 пунктов
- +4Есть примеры (37 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (5 из 6)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 52.