material-ready
Skill0 starsChanged 9 days agoMITView on GitHub
Главный рабочий цикл после запуска — «материал готов». Публикует новый материал автора, допускает темы со спросом, раздаёт черновики ролям, проводит вычитку, сверку, прорабскую приёмку и независимого читателя, публикует пачкой и проверяет подачи. Запускать на фразы «материал готов», «новый пост», «опубликуй», «запусти конвейер».
In this repository21 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- auditSkill
- checkupSkill
- designSkill
- importSkill
- infrastructureSkill
- launchSkill
- onboardingSkill
- reportSkill
- voiceSkill
- auditSkill
- checkupSkill
- designSkill
- importSkill
- infrastructureSkill
- launchSkill
- material-readySkill
- onboardingSkill
- reportSkill
- voiceSkill
The file
Files
Конвейер «материал готов» (ведущий — прораб)
Ты прораб. Роли пишут и проверяют, ты допускаешь темы, принимаешь результат, публикуешь и отвечаешь за выпуск. Роли, этапы, реестр приёмки и пределы — workflow.md; здесь — порядок шагов. Режим участия автора — workspace/brief.md → «Режим».
Шаг 0. Материал
Человек присылает ссылку на пост, текст или файл (или кладёт его в workspace/inbox/).
- Пост из публичного канала — открыть
https://t.me/s/<канал>/<номер>и взять текст; или человек вставляет текст. - Сохранить в
workspace/inbox/<дата>-<коротко>.mdи импортировать:cd engine && node scripts/import-folder.mjs ../workspace/inbox(материал короче 250 слов не публикуется; сказать об этом и спросить, публиковать ли всё равно:MIN_WORDS=0). node scripts/pipeline-check.mjs— какие материалы ещё не обработаны. Нет работы — одна строка человеку, дальше ничего не читать.
Пачка. Несколько материалов проходят шаги 0а–6 каждый, а публикация и заливка — одна на всю пачку (шаг 7).
Шаг 0а. Разметка материала
Прочитать материал целиком. Слова и стиль автора не меняются. Исправить можно только то, что ломает вёрстку: незакрытые ** и _, список, склеенный с абзацем, сломанный заголовок, скрытые символы. Опечатки и спорные места — списком автору; правка в его тексте — только если он разрешил это в брифе. Что исправлено — в журнал выпуска (шаг 9).
Шаг 1. SEO материала
seoTitle (до 70 знаков, если заголовок автора не похож на запрос), description 120–160, keywords 3–6 (2–3 главные сверить с Wordstat через журнал, как в шаге 2). Текст автора не трогать. SEO-поля проходят вычитку (roles/copy-editor.md) как любой подготовленный текст. Один материал — npm run deploy: материал на сайте сразу, разборы — следом. Пачка — без заливки здесь.
Шаг 2. Допуск тем
По knowledge/semantics.md, раздел «Семантический допуск»:
- Полный реестр событий и самостоятельных вопросов материала, включая вложенные эпизоды.
- Для каждого кандидата — формулировки и спрос: журнал Wordstat (
get→ вызов при необходимости →add), бюджет и известные ошибки MCP — там же. Ошибка или пустой ответ — «не проверено», а не ноль. - Выдача Яндекса и Google по выбранному запросу: какой ответ ищут и что добавит наша страница.
- Выбор: новый разбор, обновление живой темы (
topic-updater,_pending), новая живая тема (topic-writer; три и более материалов по сюжету — только кандидат) или отказ. Не дублировать опубликованное и текущую пачку: сверять границы ответа, а не только заголовки. Отдельный разбор внутри живой темы — при собственном запросе от 1000 показов, который тема не закрывает. - Карточка
workspace/данные/разборы/<slug>-допуск.mdс полемquery:. В теме не меньше 3 фактов и вывод автора. Slug — латиницей коротко; рубрика — изsite.config.json.
Порог показов без совпадения «запрос → потребность → ответ → исходник» допуска не даёт. Отклонённые кандидаты с причиной — в журнал выпуска.
Шаг 3. Черновики
Роли razbor-writer, topic-writer, topic-updater — до трёх одновременно. Передать: карточку допуска, slug материала и раздел, slug страницы, рубрику, дату. Ждать завершения и читать каждый файл и отчёт целиком.
Шаг 4. Вычитка
copy-editor на каждый черновик: весь файл, включая SEO-поля и FAQ, по канону копирайтинга и workspace/voice.md. Затем node scripts/acceptance.mjs record <slug> --stage edit.
Шаг 5. Сверка
razbor-checker на каждый черновик после вычитки: ссылки, факты, юридические правила, соответствие карточке допуска. Затем record <slug> --stage check.
Шаг 6. Прораб и читатель
cd engine && node scripts/lint-drafts.mjs --linksодин раз на пачку: «ошибка» — исправить или вернуть; «внимание» — разобрать по существу.- Прочитать каждый итоговый файл и все отчёты целиком: H1 и «Коротко» отвечают на запрос из карточки; страница полезна сама по себе; голос автора; оценки только от первого лица или в «Что это значит?»; юридические правила; источники открыты и подтверждают факт.
- Мелочь — исправить самому (затронутые этапы — заново). Слабая страница — вернуть роли со списком «что не так и как надо», до двух возвратов. Не вышло —
rejected: trueи в журнал как снятую. - Принял —
record <slug> --stage foreman. Правишь после своей записи или после читателя — запись прораба и круг читателя повторяются. - Читатель:
node scripts/acceptance.mjs packet <slug> --out <файл>→search-readerв свежем контексте только с ролью, пакетом и запросом. Блокеры — исправить по существу (новые факты — снова через сверку) и повторить с таблицей «находка → решение», до трёх кругов. Итог —record <slug> --stage reader …. Открытый блокер оставляет страницу в черновиках. Отдельного исполнителя запустить нельзя — читаешь сам с--independent false, и страница выходит только по явному решению человека (--override). - Режим «согласование»: собрать сайт, показать принятые черновики на
/preview/<slug>/, ждать «ок» или правки. Правка автора — правилом вworkspace/voice.md(раздел «Правки автора») и повторная приёмка затронутого. Через 2 недели предложить перейти в «прораб».
Правила прораба (типовые споры)
- Цитата расходится с первоисточником → на странице дословно по первоисточнику; оригинала нет → пересказ без кавычек. Материал автора не трогаем.
- Дата или цифра расходится с первоисточником → значение первоисточника со ссылкой. Первоисточник побеждает и материал автора, и пересказ в СМИ.
- Факт есть только у запрещённого или нежелательного ресурса → на странице его нет.
- Страница-источник издана при поддержке нежелательной организации или это стенограмма, где выступает иноагент без пометки → ссылку снять, факт дать с атрибуцией без ссылки или по другому источнику (
knowledge/legal-ru.md, раздел 1). - Факт автора без найденного источника → остаётся без ссылки и без пометки; сверщик ищет его в нескольких допустимых источниках, прежде чем так решить.
- Оценка в тексте → только от первого лица или в «Что это значит?»; третьего лица («автор считает») не бывает.
- «Что это значит?» — самостоятельное объяснение голосом автора по тезисам материала, без отсылки «в материале я писал». Вывод, оценку или прогноз, дописанные ролью, убрать, даже если они верные.
- Материал автора расходится с первоисточниками → в тексте автора не править; каждое расхождение — в журнал, раздел «Расходится с материалом».
- Сомнение, которое правила не покрывают → в пользу осторожности: убрать спорное, в журнале записать, что убрано.
Шаг 7. Публикация
До этого шага все черновики лежат с draft: true. Публикация и заливка — один раз на материал или на всю пачку:
cd engine && node scripts/publish.mjs --material <slug>[,<slug-2>,…] && npm run deploy. publish.mjs сам проверяет реестр приёмки для всей пачки и останавливается на любой странице без действующей записи — это не обходится. Перед заливкой при правках шаблонов — node scripts/review-dist.mjs и роль site-reviewer.
Шаг 8. Проверка выпуска
Новые адреса отвечают 200 — одной командой на все. Подачи (post-deploy.mjs запускается деплоем): принято ли сервисами, что осталось в очереди, какие снимки архива готовы. Ошибка сервиса — записать как ошибку, очередь сохраняется. Затем сверить реестр событий из карточек: каждая тема опубликована, снята или отклонена с причиной.
Шаг 9. Итог
- Журнал
workspace/данные/разборы/<slug-материала>-итог.md: опубликовано (ссылки, запрос, спрос), обновлено, снято и почему (в том числе ссылки по юридическим причинам), что исправил прораб, отклонённые темы, факты без источника, состояния подач и архива. Отдельный раздел для автора — «Расходится с материалом». node scripts/pipeline-check.mjs --mark <slug>[,<slug-2>,…]— только после итога.- Человеку — одна строка: «Материал на сайте. Разборов: X, обновлено тем: Y. Подробности — workspace/данные/разборы/…». Есть расхождения — добавить: «В материале N мест, где первоисточник говорит иначе, — список в журнале».
- Коммит в
workspace/.
Когда останавливаться и спрашивать (в любом режиме)
- факт не подтверждается, а без него материал теряет смысл;
- юридический риск, который правила не закрывают;
- выкладка не проходит (хостинг не пускает) — дать готовую команду:
cd <путь>/engine && npm run deploy.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
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.

