AF docs-cleaner
Консолидирует избыточную документацию, сохраняя весь ценный контент; поддерживает актуальность набора документов после изменений. Режимы: (1) УПРАВЛЕНИЕ ПОСЛЕ ИЗМЕНЕНИЙ — когда изменился код, скрипты, конфигурация, переменные среды, порты, пути, развертывание, аутентификация, тесты или документированная процедура; также "какие документы теперь неверны", "проверить документы на несоответствия", "过时的命令/路径", "文档同步". Используйте его, даже когда пользователь упоминает только изменение, а не документы — их обновление является частью изменения, а не необязательной очисткой. (2) КОНСОЛИДАЦИЯ — "очистить документацию", "раздувание документации", "уменьшить распространение документации", "консолидировать документацию", "слишком много файлов документации", "объединить избыточные документы", "объединить эти документы", "文档太多/太乱", несколько файлов, охватывающих одну и ту же тему, или документация, превышающая 500 строк в нескольких файлах на схожие темы. Находит устаревшие копии фактов, измененных только в одном месте, значения, которые никогда не должны были быть сохранены (счетчики, итоги, "N элементов", пересказанные резюме), конкурирующие определения, которые расходятся, и потерянные перекрестные ссылки.
машинный переводПоказать оригиналСкрыть оригинал«Consolidates redundant documentation while preserving all valuable con…»
Consolidates redundant documentation while preserving all valuable content; keeps a doc set truthful after things change. Modes: (1) POST-CHANGE GOVERNANCE — when code, scripts, config, env vars, ports, paths, deployment, auth, tests, or a documented procedure changed; also "which docs are now wrong", "check docs for inconsistencies", "过时的命令/路径", "文档同步". Use it even when the user mentions only the change and never the docs — updating them is part of the change, not optional cleanup. (2) CONSOLIDATION — "clean up docs", "documentation bloat", "reduce documentation sprawl", "consolidate documentation", "too many doc files", "merge redundant docs", "merge these docs", "文档太多/太乱", multiple files covering the same topic, or documentation exceeding 500 lines across multiple files on similar topics. Finds stale copies of a fact changed in only one place, values that should never have been persisted (counts, totals, "N items", restated summaries), rival definitions that drift apart, and orphaned cross-references.
Консолидирует избыточную документацию, сохраняя весь ценный контент; поддерживает актуальность набора документов после изменений.
Как процесс F 54/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: 个|条|步|项|点
Как улучшить
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
body-longтело SKILL.md ≈ 11943 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: 个|条|步|项|点 - заметка
edit-residueв тексте есть пометки об устаревшем (строки 203, 206): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия
Процессный рейтинг: все десять параметров 54/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): 个|条|步|项|点
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 30Повторный запуск. Изменяющих операций: 67, без проверки текущего состояния
- 40Стоимость исполнения. Тело инструкции 11943 токенов: вытесняет саму задачу из окна
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 100Шаги. Шагов: 46
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Согласованность. Имя и обязательные поля на месте
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 10. Похоже на несколько доменов в одном скилле
- low Ответ описан самодельной разметкой (5 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1019: рекомендуется 120–800 символов
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 12 примера фраз-триггеров в кавычках
- +4Структура: 20 заголовков
- +3Пошаговые инструкции: 46 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (10 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (1 из 1)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 77.