Forward implementation first — скилл

Скилл против зацикливания агента на служебных хешах, замках и квитанциях: сначала результат, потом проверка

  • 185 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл велит убирать из пути выполнения административные зависимости, то есть агент правит скрипты и настройки конвейера.
Все причины и проверки

vuk97/forward-implementation-first

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/forward-implementation-first

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл велит убирать из пути выполнения административные зависимости, то есть агент правит скрипты и настройки конвейера.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Forward implementation first — скилл на 150 строк Markdown для долгих конвейеров, где агент начинает обслуживать собственную бухгалтерию: хеши входных данных, файлы блокировок, квитанции о прохождении этапа, маркеры сертификации, строки дашбордов. Перед каждым действием скилл заставляет отнести его к одному из трех классов: реализация, точечная проверка или служебный учет. Первые два делаются, третий пропускается, пока вы его не попросите или он не входит в продукт. Правило «движения вперед» разрешает откатывать или перезапускать этап только по реальной причине: изменился смысл входа, версия цели, вывод поврежден или несовместим с потребителем, прогон опроверг прежний результат, того требует зависимость изменившегося генератора. Если этап заблокирован одним лишь маркером, агент запускает его вручную, проверяет вывод, публикует, идет дальше и убирает такой замок из пути. Скилл сохраняет все, что защищает корректность: контрольные суммы и подписи, которые проверяют пользователи, идентичность версии входа, тесты с проверкой результата. Параллельные воркеры допускаются при одном писателе, который публикует итоги и двигает курсор.

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

Подходит, если

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

Не подходит, если

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

Пример запроса к агенту

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

Ограничения

Скилл остается рекомендацией: модель сама решает, подгружать ли его, поэтому правило при необходимости дублируют в постоянных инструкциях или хуках агента. После установки агент перезапускают, потому что запущенные сессии скиллы не перечитывают. Скрипт `install.sh` копирует файл только в каталоги Claude Code, Codex и общий `~/.agents/skills`, для других агентов копию кладут вручную. Для установки в один проект каталог копируют в `.claude/skills/` или `.agents/skills/` репозитория.

Как отключить. Удалите каталог `forward-implementation-first` из `~/.claude/skills/`, `~/.codex/skills/` или `~/.agents/skills/`, где его создал `install.sh`, и перезапустите агента.

Частые вопросы

Куда install.sh копирует скилл?

В `~/.claude/skills/forward-implementation-first/`, `~/.codex/skills/forward-implementation-first/` и `~/.agents/skills/forward-implementation-first/`, но только в те каталоги, которые нашел на машине.

Что скилл не отменяет?

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

Как убедиться, что агент видит скилл?

Перезапустите агента и попросите назвать правило выбора действия. Если ответа нет, проверьте, что `SKILL.md` лежит в каталоге скиллов этого агента.

Для чего нужен examples/execution-profile.md?

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

Для каких пайплайнов автор приводит примеры?

Поэтапные данные и ETL, крупные миграции кода, сборка и релиз, генерация документации по многим входам, пакетный анализ и дорожные карты, над которыми агент работает днями.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл дисциплины завершения для крупных задач агента: сначала список приемки с проверками, потом работа, затем повторная сверка по доказательствам

СкиллРасширенный доступ4,4 тыс.Звезды репозитория

Скилл и хуки, которые удерживают кодового агента в рамках задачи и убирают лишнюю защиту, ненужные контрольные суммы и расползание объема

ПлагинРасширенный доступ3,9 тыс.Звезды репозитория

Скилл-мастерская: агент проверяет готовый скилл, ищет аналоги, оценивает и правит по шагам с проверкой каждой правки.

СкиллРасширенный доступ967Звезды репозитория

Метаскилл превращает разрозненные правила в AGENTS.md, CLAUDE.md и Cursor в один проверяемый скилл проекта с маршрутами задач.

ПлагинРасширенный доступ622Звезды репозитория

Self-learning

self-learning-skills

Мета-скилл, который после трудной задачи сохраняет найденный рабочий путь в новый скилл или правило для следующих сессий

СкиллРасширенный доступ971Звезды репозитория
Выбор редакции

Скилл держит план задачи в файлах на диске и переносит его в контекст на каждом шаге, чтобы работа переживала очистку контекста, компактизацию и сбои

СкиллРасширенный доступ28 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Forward implementation first (эта карточка)нет185
Правила для Claude Code по мотивам Карпатынет232 318четыре общих принципа против ошибок LLM в коде; здесь одно правило про служебный учет конвейеров и откат этапов
Planning with Filesнет28 020держит план задачи в файлах на диске; здесь запрет чинить служебные маркеры вместо результата

Коротко о README

README разбирает типичный сбой на примере конвейера, где смена одного генератора ломает хеш и агент перезапускает этапы с 12 по 40, затем описывает установку и случаи, когда скилл нужен. Автор рассказывает происхождение: сначала это был промпт, который приходилось вставлять в начало каждой сессии. Пример профиля запуска лежит в `examples/execution-profile.md`.

Бейдж для README

Исходный SKILL.md

---
name: forward-implementation-first
description: >
  Keeps an agent building and validating real output instead of servicing its
  own bookkeeping. Use for multi-stage pipelines, capability roadmaps,
  long-running implementation loops, migrations, staged data or build runs, and
  any run where administrative hashes, locks, receipts, dashboards,
  certification markers, or progress metadata can block correct work. Use when
  an agent refuses to advance, rewinds finished stages, or reruns unchanged
  work because a marker is missing or stale.
---

# Forward implementation first

Build working capability and correct output before administrative bookkeeping.
Apply this contract both while building a system and while running it.

## Scope

This skill applies to:

- infrastructure and roadmap implementation;
- input intake and intermediate artifact production;
- transformation, derivation, and analysis stages;
- test construction, runtime verification, and measurement;
- publication of final output and closeout;
- manual invocation of any authorized pipeline stage.

It applies whether the action runs through a full orchestrator, a focused
command, or a manual stage invocation.

## Decision rule

Before each action, classify it as one of:

1. **Semantic implementation**: builds or connects a producer, consumer,
   adapter, runtime path, schema, fixture, or final output.
2. **Focused validation**: tests the changed dependency cone through behavior,
   schema, counts, samples, conservation, consistency, nontruncation, or
   measured resources.
3. **Administrative bookkeeping**: generates or repairs hashes, locks,
   receipts, dashboards, certification markers, progress metadata, or
   presence-only records.

Choose categories 1 and 2. Skip category 3 unless the user asks for it or the
artifact is itself part of the product. When administrative work blocks a path
without protecting correctness, remove that dependency from the path.

## Hard constraints

Сообщить о проблеме