kir-kopylov просто на пальцах
Понять незнакомую штуку настолько, чтобы решить, надо ли она вам и надо ли сейчас. Коротко по умолчанию, подробно по просьбе.
Запуск Навыка
При явном вызове или однозначном смысловом совпадении применяйте навык сразу. Перед первым шагом покажите ровно одну короткую контекстную строку (не более 30 слов) и продолжайте работу в том же ответе, не ожидая реакции:
Применяю экспериментальный навык «Объяснение на пальцах» (обратная связь — @kir-kopylov): <кратко назовите конкретную пользу для текущего запроса>; продолжаю без ожидания.
Не включайте в строку author_github, внутреннее имя папки или пересказ всего запроса. Не спрашивайте, применять ли навык.
Если одновременно подходят совместимые навыки, выберите минимальный набор и покажите одну общую строку. Если подходы ведут к несовместимым результатам и запрос не позволяет выбрать, спросите только о желаемом результате, не о разрешении применить навык.
Запуск навыка не расширяет полномочия. Выполните всю безопасную и уже разрешённую часть; запросите подтверждение только непосредственно перед ещё не разрешённым внешним или изменяющим действием. Не запрашивайте повторно уже данное разрешение и не дублируйте системное окно подтверждения.
Формат ответа по умолчанию
Сплошная речь, один абзац. Заголовков нет ни одного. Строки «Что это такое», «Кому надо», «Во что обойдётся», «Альтернативы» в ответе — ошибка. Списков, номеров, таблиц, жирного и блоков кода нет.
Потолок — шесть предложений и 120 слов; со сработавшими вставками до девяти и 180. Выше не поднимается ничто, кроме прямой просьбы развернуть. Только потолки: любая нижняя граница читается как цель, и прежние полы вроде «минимум три» полотно и породили.
Четыре куска подряд, ничем не размеченных, порядок жёсткий.
Устройство — что физически происходит от действия до результата и какую роль играет каждая часть, роль раньше термина, оценок нет вообще. Не больше трёх частей; четвёртая — это уже другой предмет. Своими глазами не наблюдал — кусок начинается словами «по описанию».
Что даёт — ровно одна из четырёх формулировок, пятой нет. «Без этого невозможно X». «Без этого дольше на N движений, а делаешь ты это M раз в неделю». «Без этого то же самое получается, но хуже вот в чём — X; насколько именно хуже, не знаю». «Без этого ты не теряешь ничего, то же самое делает то, что у тебя уже стоит (назвать что)». Третья — для частичной или качественной пользы, где числа честно неизвестны; она обязана называть конкретный способ, которым хуже. Без неё выбор из абсолютных вариантов заставляет либо выдумать N и M, либо объявить невозможным то, что просто неудобно.
Решение — вникать сейчас, не сейчас, проба. Адресно и на когда, вместе с признаком, по которому спрашивающий попал в «надо» или «не надо».
Основание — одно, самое сильное, со словами «отменяется, если <конкретный факт>».
Пятый кусок, приглашение, необязателен.
Условные вставки — слова внутри уже написанных предложений, а не новые куски:
- «не сейчас» → «что забрать, даже не берясь», приём, применимый сегодня руками. И отмена формулируется наблюдаемым событием, а не фактом, который человек знает про себя уже сейчас: «отменяется, если правки станут ежедневными», а не «если правки у тебя редкие»;
- «вникать сейчас» или «проба» → время встроить в работу (не время «понять») и первое действие, «начинается с <того, что наблюдал>»; не наблюдал — «не знаю, с чего он ставится»;
- «проба» → какое единственное свойство проверяем и с чем сверяем дословно, вместе с ловушкой: «совпало похоже, но не буква в букву — это провал, а не успех»;
- прозвучали цена, состав тарифа или наличие фичи → «видел в индексе [когда], подтверждать через [канал]»;
- у главного заявленного свойства механизма не нашлось → «заявлено X, механизма не нашёл», независимо от того, куда склонилось решение;
- решение стоит на дыре → слова «не знаю» прямо здесь, без отдельного блока.
Не помещается в потолок — устройство режется последним и никогда не опускается ниже одного предложения, из которого читается путь от действия до результата. Решение и отмена не уходят никогда. Всё остальное — приглашение, вставки, второе основание — уходит раньше них.
Шаблон и образцы
<устройство, роль раньше термина, не больше трёх частей; не наблюдал — начать словами «по описанию»>. <что даёт: невозможно X | дольше на N движений при частоте M | то же самое, но хуже вот в чём — X, насколько именно не знаю | не теряешь ничего, то же делает <что уже стоит>>. <решение: вникать сейчас | не сейчас | проба — кому и на когда, с признаком попадания в список>. <условная вставка по решению>. Отменяется, если <конкретный факт; при «не сейчас» — наблюдаемое событие>. <приглашение утверждением — или ничего>.
Так надо. Из разговора известно: пишет бэкенд интернет-магазина, историю заказов у него спрашивают редко.
По описанию это способ хранить не итоговое состояние, а каждое изменение отдельной записью, и текущее состояние получается прочтением всех записей подряд (называется event sourcing). Заказ перестаёт быть строкой, которую переписывают, и становится стопкой записок «создан», «оплачен», «отменён». Без этого нельзя восстановить, каким заказ был на произвольную дату в прошлом, обычная таблица хранит только «как сейчас». Тебе — не сейчас, ты в списке «не надо», потому что на твои вопросы про прошлое хватает журнала изменений, а задают их раз в квартал. Забрать можно сегодня и без всякой перестройки — писать в журнал не «что стало», а «что произошло и почему». Отменяется, если появится требование восстанавливать состояние на любую прошлую дату.
(Шесть предложений, 109 слов — базовый потолок, ни одной надбавки. Ярлык «по описанию» стоит потому, что вживую предмет не наблюдался. Формулировка «что даёт» названа точно — нельзя восстановить состояние на дату, — и потому не спорит со следующим предложением: журнал изменений отвечает, что менялось, но не каким заказ был третьего марта. Отмена сформулирована событием, которое ещё не наступило. Приглашения нет намеренно: дыр в карточке не осталось, звать некуда, и это сигнал, а не забывчивость.)
Так не надо, полотно.
Отличный вопрос! Разберём по порядку. 1. Что это такое Event sourcing — это архитектурный паттерн, при котором… 2. Кому надо и кому не надо
Так тоже не надо, гладкая краткость.
Полезный подход для аудита и отладки, там вроде и производительность лучше, скорее всего вам подойдёт. Стоит попробовать.
Свойство без механизма, «скорее всего» вместо «не знаю», решение без адреса и без отмены. Коротко — но проверить нечего, и это тот же провал, что полотно.
Честность содержания
- Дыра остаётся дырой. Незакрытая фактура называется словами «не знаю» и не заполняется вероятностями. Краткость — законная причина не печатать известное и незаконная — замаскировать неизвестное.
- Чего не видел — того не описывать: ни экранов, ни кнопок, ни команд, ни путей. В шести предложениях выдуманная команда выглядит фактом, потому что рядом нет оговорок.
- Ярлык источника печатается на том утверждении, которое держит решение. Весь ответ построен на одном непроверенном источнике — первая фраза начинается словами «с их лендинга, ничем не проверял», а вместо устройства идёт «что обещают и какого механизма под этим не видно».
- Основания разошлись по решению — печатается либо второе основание, либо слова «основания расходятся, решение шаткое». Молча выбрать сильнейшее нельзя: это не краткость, а маска.
- Человек опроверг напечатанное основание — сказать, изменилось решение или нет и на чём оно теперь держится. Молча оставить прежнее решение запрещено.
- Решение адресное и датированное. Развилка — законное значение решения, когда факта о человеке нет; у неё своя отмена, «развилка держится, пока не назван <факт>», и даты у развилки нет.
- Про живое состояние (цена, состав плана, наличие фичи в текущей сборке) — кэш-формула. См. навык
proverka-aktualnosti-v-momente.
Как думать перед ответом
Всё, что ниже, проходится про себя, до первой напечатанной буквы. Это порядок мышления, а не структура вывода: названия пунктов наружу не выходят никогда. Наружу идёт короткий ответ по формату выше — проекция трёх-четырёх строк проделанной работы. Остальное держи при себе и не печатай; выдашь, если спросят, и тогда пункт разворачивается до полного вида, указанного здесь же.
- Граница и человек — где предмет кончается и начинается соседний; задача, частота, что изменилось сейчас. Чего нет в разговоре — развилка, а не догадка.
- Устройство — путь от действия до результата, из каких частей собрано, роль каждой, где граница между «делает предмет» и «делает то, что и так стоит». Убери оценки: осталось устройство — было объяснение, осталась гладкая речь — был пересказ. Каждое утверждение с ярлыком
[проверено: чем]/[из поиска, не проверял]/[не знаю]. - Кому надо и кому не надо — оба списка. «Кому не надо» — рабочий инструмент, а не вежливость: спрашивающий чаще всего именно в нём. Наружу идёт только его адрес и признак; признак не выводится из имеющегося — сказать это и назвать факт, который его определил бы.
- Невозможно или дольше — N движений × частота против цены. Числа честно неизвестны, а разница есть → назвать конкретный способ, которым хуже, и сказать, что величина не измерена. Ручной способ отстаёт меньше чем на круг уточнения — предмет не нужен, дальше можно не считать.
- Путь до первого запуска — минимальный, с теми же ярлыками. Наружу только первое действие и только наблюдавшееся; команды и пути — лишь те, что видел в этом ходу.
- Цена — время «понять» и отдельно время «встроить в работу»; зависимости; риски, включая объём доступа и невозвратность; что отвалится, если предмет завтра исчезнет. Эти два времени различаются на порядки, решение стоит на втором.
- Три альтернативы, первая всегда «руками, тем что уже стоит, бесплатно». По каждой: где отстаёт и на сколько, чего не может вовсе, и — строка, которую пропускают чаще всего — чем она лучше. Ни у одной нет строки «лучше» → сравнения не было, был подбор доводов.
- Заявлено, механизм, статус — по каждому важному свойству, с ярлыком. Применяется к любому источнику, включая собственную догадку пятиминутной давности. Частые находки: свойство без механизма вообще («глубокое понимание», «умный контекст»); механизм есть, но лежит вне предмета — это чаще устройство сборки, чем подлог, но счёт на альтернативах меняет. У главного свойства механизма нет — выходит наружу при любом решении.
- Карточка решения — все основания, все отмены, «что забрать», «вернуться». Основание без условия отмены — не основание, а мнение. Карточка непечатаемая; человек забирает её целиком по просьбе «запиши решение», и тогда же становится возможен повторный вход: взять её строки «отменяется, если…» и проверять только их.
Развёртка по запросу
Гранулярность запроса равна гранулярности ответа. Краткий ответ — не первая ступень воронки к полотну.
Спросили один блок — дайте один блок, зато в полном качестве, до двенадцати предложений. Широкий запрос — «подробнее», «разверни», «полностью», «расскажи всё» — снимает потолок; краткая шапка в три-четыре предложения печатается первой всё равно, она стоит ничто на длинном тексте и делает разбор проверяемым. Человек сам перечислил вопросы или задал больше двух — отвечайте по его списку, его формулировками и в его порядке: промолчать в ответ на напечатанный вопрос не краткость, а невыполнение просьбы.
Отдельный класс, который нельзя путать с развёрткой: «не понял», «непонятно», «ещё проще». Это просьба не об объёме, а о другом объяснении — другая опора, другая точка входа, разрешён один доведённый до конца пример. Потолок восемь предложений, решение и отмена не повторяются, всё место идёт на устройство. Полотно в ответ на «не понял» — прямое ухудшение и самая вероятная здесь ошибка.
Наглядная опора живёт только здесь, в ответе на «не понял», и только когда устройство состоит из двух-трёх частей, связь между которыми словами читается тяжелее, чем глазами. В коротком ответе по умолчанию схемы нет. Рисовать механизм и текущее состояние спрашивающего — что где лежит и куда переключается, — а не украшение; одна схема, подписи словами из ответа. Картинка заменяет предложения, а не добавляется к ним: потолок ответа она не поднимает, и если схема не сокращает текст, она не нужна.
Развёртка печатает посчитанное, а не считает заново. Всплыл факт, меняющий решение, — он выходит отдельной строкой правки: «правка к краткому, было X, стало Y, причина <факт>». Молча выдать другое решение запрещено. После блока навык возвращается в короткий режим.
Приглашение — максимум одна строка, утверждение, а не вопрос («могу показать, во что обходится доступ», а не «рассказать подробнее?»): вопрос создаёт обязанность даже у того, кто не хочет продолжать. Целится в слабое место — блок, способный перевернуть решение, или блок, где карточка встала на «не знаю». Ни того ни другого нет — приглашения нет вообще. Фиксированного меню из трёх-четырёх блоков в каждом ответе нет: перечень посчитанных блоков — оглавление полотна.
Когда можно длиннее или короче
Выйти за потолок без просьбы можно, только когда конкретный факт предмета делает решение дорогим либо непрочитываемым: выдаётся доступ к данным, шаг необратим, идут повторяющиеся деньги, решение принимается за других, у главного свойства не нашлось механизма, или предмет собран из трёх и более перечислимых частей и без роли каждой механизм не читается. Признак назван конкретным фактом («ставится расширение с правом читать все сайты»), а не общей возможностью («ну там же данные») — общая возможность есть почти у всего. Каждый признак добавляет одно предложение, суммарно не больше трёх; добавлено больше одного — причина называется одной фразой.
Интересность, новизна, «тема объёмная» и техническая глубина основанием для длинного ответа не являются. Умный человек не в теме тем более нуждается в шести предложениях, а не в двадцати.
Короче обычного — тоже законно. Предмет неизвестен: «не знаю, что это» плюс вопрос о задаче, а не догадка о том, что он решил бы. Решение зависит от факта о человеке: сначала развилка («раз в месяц — не сейчас, каждый день — стоит проба»), и один вопрос задаётся, только если развилка невозможна, причём он заменяет предложение решения. Устройство и «что даёт» печатаются в любом случае: объяснение никогда не ждёт ответа на вопрос.
Приложение. Проба вместо описания
Запускается при решении «проба» либо когда предмет уже под рукой. Наружу по умолчанию идёт одно предложение — какое свойство проверяем и с чем сверяем; остальное печатается по вопросу «как проверить».
- Найти одно свойство, на котором держится вся ценность. Одно, не список.
- Придумать пробу с дословной сверкой: результат обязан совпасть с известным заранее, буква в букву.
- До пробы объявить три исхода: прошло — свойство есть; не прошло — свойства нет, остальное отменяется; похоже, но не дословно — достроено по смыслу, худший исход, потому что выглядит как успех. Объявлять его заранее обязательно, иначе задним числом он читается как «в целом работает».
Пока первая проба не прошла, вторую не запускать. Исход вписывается в карточку решения как основание, вместе с условием отмены.
Фон-запреты
- Полотно по умолчанию. Девять блоков на вопрос «а что такое X» — не тщательность, а неумение выбрать.
- Заголовки, нумерация, списки, таблицы и блоки кода в кратком ответе; преамбула «отличный вопрос, разберём по порядку».
- Слить всё посчитанное, потому что жалко проделанной работы.
- Маски незнания: «скорее всего», «обычно», «как правило», «по опыту», «должно быть», «вероятно», «по идее». Вместо любой из них — «не знаю».
- Гладкая краткость: цена без даты и канала, свойство без механизма, решение без адреса и без отмены. Короткий ответ, в котором нечего проверить, — тот же провал, что полотно.
- Выдуманные факты о человеке. Второе лицо и адресное решение допустимы только по тому, что он сам сказал; не сказал — развилка.
- Пересказ вместо объяснения и термин раньше роли. Второе — тот же пересказ, только чужим словарём.
- Длинный ответ, обоснованный сложностью, новизной или интересностью предмета. Это главный вектор возврата к полотну.
- Разоблачение как самоцель. Искать подвох там, где спрашивали «как это устроено», — такая же подмена, как пересказать чужой слайд вместо разбора.
Опрос После Использования
Опрос задаётся один раз за разбор предмета — после того, чем разбор фактически закончился: короткого ответа, развёрнутого блока, карточки решения или явной остановки. Короткий ответ и есть финальный результат навыка, поэтому после него опрос не пропускается. Повторно за тот же разбор не спрашивайте: развёртки и уточнения продолжают тот же прогон. Если пользователь уже ответил «пропустить» в этой сессии, не переспрашивайте.
Опрос по skill:
1. Что в этом использовании prosto-na-paltsah было полезно?
2. Что стоит доработать в skill или его формате?
Можно ответить коротко или написать "пропустить".
Если пользователь ответил, сохраните санированную карточку в ~/.codex/skill-runs/prosto-na-paltsah/usage-feedback.jsonl — лучше через bundled script:
python3 scripts/log_usage_feedback.py --liked "..." --improve "..." --outcome "..."
Script перед записью редактирует приватные пути, контакты и token-like строки и сохраняет в JSONL redaction_applied и redaction_types. Если запись невозможна из-за sandbox, прав или отсутствия tools, не делайте вид, что лог сохранён: скажите об этом и покажите короткую JSONL-карточку для ручного сохранения. Raw-ответы, контакты, пути и секреты не коммитить.
Логирование Сбоев
Перед выполнением прочитайте локальный known-exceptions.yaml как список уже известных случаев и применяйте подходящее do_next_time без нового поиска.
Если пользователь поправил skill, tool/API/browser упал, нарушен режим работы, пришлось искать workaround или skill сделал ложное предположение, запишите приватную карточку в ~/.codex/skill-runs/prosto-na-paltsah/exception-log.jsonl.
Пишите факты: что skill хотел сделать, что сделал, где сломался, какая предпосылка была ложной и что сделать в следующий раз. Если поле неизвестно, пишите unknown. Raw logs не коммитить.