AB doc-and-modernize
Два связанных рабочих процесса для локально клонированного кодовой базы в одном навыке. Режим документации создает единый, всеобъемлющий, проверяемый документ архитектуры, в основном читая файлы на диске (локальный приоритет) — используйте его всякий раз, когда пользователь хочет понять, сопоставить, документировать, исследовать или освоить кодовую базу ("исследовать этот репозиторий", "описать архитектуру", "провести глубокое погружение в архитектуру", "документировать, как работает эта кодовая база", "составить карту системного дизайна", "создать документ для онбординга"). Режим модернизации генерирует поэтапный план модернизации, миграции, обновления или переписывания устаревшей системы ("модернизировать это", "спланировать миграцию", "как бы мы это переписали", "как нам отказаться от этого устаревшего стека"); если документ архитектуры еще не существует, он сначала запускает режим документации, а затем переходит к плану. Он предполагает, что устаревший стек может быть мертв, запускает ограниченное по времени исследование осуществимости и выбирает самую высокую достижимую ступень на лестнице безопасности вместо того, чтобы требовать полностью зеленую проверку CI устаревшего стека с самого начала.
машинный переводПоказать оригиналСкрыть оригинал«Two related workflows for a locally-cloned codebase, in one skill. Doc…»
Two related workflows for a locally-cloned codebase, in one skill. Documentation mode produces a single, comprehensive, verifiable architecture document primarily by reading files on disk (local-first) — use it whenever the user wants to understand, map, document, research, or onboard onto a codebase ("research this repo", "write up the architecture", "do an architecture deep dive", "document how this codebase works", "map the system design", "create an onboarding doc"). Modernization mode generates a phased plan to modernize, migrate, upgrade, or rewrite a legacy system ("modernize this", "plan the migration", "how would we rewrite this", "how do we get off this legacy stack"); if no architecture document exists yet it first runs Documentation mode, then continues straight through to the plan. It assumes the legacy stack may be dead, runs a time-boxed feasibility spike, and picks the highest achievable rung on a safety ladder instead of demanding a fully-green legacy CI gate up front.
Два связанных рабочих процесса для локально клонированного кодовой базы в одном навыке.
Как процесс B 76/100 · Почти готов — слабые места: стоимость исполнения
Как улучшить
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 3. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
body-longтело SKILL.md ≈ 12118 токенов (рекомендуется < 5000); вынесите детали в references/ - заметка
edit-residueв тексте есть пометки об устаревшем (строки 11, 189, 197, 201, 247, 292): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия
Процессный рейтинг: все десять параметров 76/100
- 40Стоимость исполнения. Тело инструкции 12118 токенов: вытесняет саму задачу из окна
- 60Инструменты и файлы. Используются инструменты (bash, web, python, node), но во frontmatter они не объявлены
- 60Шаги. Шагов: 142, расплывчатых формулировок: 8
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Результат и критерий готовности. Формат результата и критерий готовности описаны
- 100Ошибки и развилки. Развилок: 5, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1000: рекомендуется 120–800 символов
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 10 примера фраз-триггеров в кавычках
- +4Структура: 27 заголовков
- +3Пошаговые инструкции: 142 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (2 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (2 из 2)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 83.