DD ad-guidelines
Создание или обновление файла `GUIDELINES.md` в корне репозитория — полное инженерное руководство проекта. Член триады Конституции уровня 1 (вместе с универсальной философией `WORKFLOW.md` и сжатыми правилами `AGENTS.md`). Охватывает привязку к Clean Architecture, применение SOLID, уровень Object Calisthenics (слабый / умеренный / строгий по Bay 2008), соглашения об именовании, обработку ошибок, дисциплину сложности, правила API, стандарты производительности, систему сборки, статическую аналитику, уровни качества, стратегию тестирования, рабочий процесс Git, документацию и безопасность. Сначала сканирует — читает инструментарий языка, существующую конфигурацию тестов/линтеров/форматирования и существующие разделы AGENTS.md, предварительно заполняет каждый проверяемый плейсхолдер, а затем задает вопросы только по реальным пробелам и предпочтениям. Используйте, когда пользователь хочет создать, подготовить, проверить или обновить инженерные руководства / стандарты кода / соглашения о кодировании / применение SOLID / Object Calisthenics / стратегию тестирования / политику безопасности / соглашения о сборке для проекта. Навык ленивый — файл существует только тогда, когда проекту нужны инженерные стандарты.
машинный переводПоказать оригиналСкрыть оригинал«Draft or update `GUIDELINES.md` at the repo root — the project's full…»
Draft or update `GUIDELINES.md` at the repo root — the project's full engineering reference. Layer 1 Constitution trinity member (alongside `WORKFLOW.md` universal philosophy and `AGENTS.md` distilled rules). Covers Clean Architecture binding, SOLID application, Object Calisthenics tier (loose / moderate / strict per Bay 2008), naming conventions, error handling, complexity discipline, API rules, performance standards, build system, static analysis, quality gates, testing strategy, git workflow, documentation, and security. Scan-first — reads language toolchain, existing test/lint/format config, and existing AGENTS.md sections, pre-fills every placeholder it can verify, then asks only the genuine gaps and preference questions. Use when the user wants to draft, scaffold, audit, or update engineering guidelines / code standards / coding conventions / SOLID adoption / Object Calisthenics / testing strategy / security policy / build conventions for the project. Skill is lazy — file only exists when the project needs engineering standards.
Создание или обновление файла GUIDELINES.md в корне репозитория — полное инженерное руководство проекта. Член триады Конституции уровня 1 (вместе с…
Как процесс D 44/100 · Процесс не доведён — Скилл ссылается на файлы, которых нет в архиве: templates/guidelines.md
Как улучшить
- Сократите description до 1024 символов.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1050 символов, лимит 1024 - предупреждение
missing-refссылка на отсутствующий файл: templates/guidelines.md - заметка
frontmatter-keyнеизвестное поле фронтматтера "summary"
Процессный рейтинг: все десять параметров 44/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): templates/guidelines.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 5, без проверки текущего состояния
- 55Ошибки и развилки. Развилок: 1
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 100Шаги. Шагов: 33
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1861 токенов
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- high Скилл велит модели самой совершать необратимое действие, без подтверждения человеком
- low Ответ описан самодельной разметкой (4 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1050: рекомендуется 120–800 символов
- +4Структура: 0 заголовков, инструкции сложно сканировать
- +3Формат ответа не описан: модель каждый раз решает сама
- -5Длинный текст без заголовков
- -5В тексте остались TODO / заглушки
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Пошаговые инструкции: 33 пунктов
- +4Есть примеры (1 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 35.