agentleFS
dewildewil/ai-toolkit/skills/proofread/SKILL.md

proofread

Skill9 starsChanged 2 months agoMITView on GitHub

Обязательно перед выдачей значимого готового документа, задачи или сообщения с последствиями: вычитка существующего текста на ясность и сохранение смысла. Не для сбора новых требований, конвертации или утверждения решений.

Files
SKILL.md

Редакторская вычитка

Используй общие нормы ясного и соразмерного текста. Эта процедура проверяет существующий текст на ясность и сохранение смысла; она не собирает новые требования, не конвертирует текст и не утверждает решение.

Когда применять

Вычитка обязательна перед выдачей готового значимого ТЗ, спецификации, архитектурного описания, регламента или инструкции; перед передачей готового документа команде или заказчику либо перед публикацией; а также при существенной редактуре, способной изменить смысл.

Для задачи применяй навык при передаче исполнителю объема работ, срока, ответственности или критериев приемки. Для сообщения — когда оно фиксирует договоренность, обязательство, решение, изменение требований или важную позицию.

Оценивай последствия и назначение текста. Обычный ответ, статус, организационная реплика, уточнение, короткая личная заметка и исправление опечатки обычно не требуют отдельной процедуры. Длина сама по себе не делает черновик готовым документом и не запускает вычитку. Применяй навык вне обязательных случаев, если пользователь явно просит об этом.

Порядок работы

  1. Найди и зафиксируй проверяемый исходный текст, его адресата, жанр, версию и границы правки. Определи, кому и для какого действия или решения он предназначен.
  2. Прочитай нужные действующие и исторические ссылки, требования проекта и применимые правила. Не добавляй факты, предпосылки, определения, объем работ или решения за владельца. Сомнения и незаполненные места оставляй явными.
  3. Отредактируй текст для ясности, связности и конкретности. Подбирай структуру под его жанр и адресата; не применяй универсальный шаблон и не сокращай ради сокращения. При вычитке пройди проверки из общего правила: основания выводов, содержательность перечней и диапазонов, устойчивость именования, исполнитель действия и подтверждающие ссылки. Если для проверки не хватает доступных материалов или требуется отдельное исследование, зафиксируй вопрос и ограничение проверки; без поручения не расширяй объем работы. Не выдавай стилистическую правку за проверку фактов.
  4. Сопоставь редакцию с исходником. Отдельно проверь исполнителей, модальность, отрицания, числа и единицы, сроки, условия и исключения, права, статусы решений, причинные связи и направления зависимостей. Сохрани стабильные термины, точные цитаты, ID, названия API, команды, данные и юридические или замороженные фрагменты. Машинные форматы должны сохранить синтаксис, поля и значения.
  5. Повторно проверь новую редакцию, если после проверки существенно менялись смысл, условия, обязательства, числа, идентификаторы или границы документа.
  6. Сообщи краткий результат: что стало яснее и что выявлено о сохранности смысла. Отметь нерешенные вопросы и ограничения проверки.

Независимая сверка и выпуск

Если принятый SDD или правила проекта требуют независимую сверку, сверь исходник и редакцию по этому процессу. Сверка должна относиться к той же точной финальной редакции. Если эквивалентная сверка этой редакции уже выполнена в SDD и это подтверждено, засчитай ее; не запускай дублирующий платный проход. Не ослабляй принятую обязательную проверку. Собственная вычитка не является независимой проверкой. Если принятого процесса нет, отдели собственную вычитку от непроведенной независимой сверки и не выдавай ее за результат независимой сверки. Не меняй проверяющего или процесс автоматически и не передавай текст внешней модели автоматически.

Если обязательная независимая проверка недоступна или ее эквивалентность не подтверждена, отметь результат как ожидающий или NOTRUN по правилам проекта; не объявляй PASS. Редакторский PASS не является приемкой владельцем и не разрешает отправку, публикацию, изменение персональных сведений или принятие решения. Получи требуемое отдельное разрешение до внешнего действия.

Для coding-проекта с принятыми нормами трассируемости и SDD следуй локальным правилам. Если они недоступны, можно использовать справочные нормы трассируемости и описание SDD; ссылки сами по себе не вводят этот процесс.

Модель и текущие назначения

Перед новым заданием и запуском применяй маршрутизацию моделей: свежий MODELS выше канонического дефолта. Границы данных и полномочий этого навыка сохраняются.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.