pipeline
Дисциплинированный пайплайн разработки проекта по стадиям 0–10 — context load → idea → plan + criteria → risk spikes → contracts → vertical slice → tasks → implementation → audit → feedback → release. Используй, когда пользователь начинает новый проект, говорит "запусти пайплайн", "по нашему процессу", "следующая стадия", или когда в проекте есть docs/pipeline/state.md и надо продолжить работу.
Magerko · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Magerko/claude-code-skills --skill pipeline技能说明
name: pipeline description: Дисциплинированный пайплайн разработки проекта по стадиям 0–10 — context load → idea → plan + criteria → risk spikes → contracts → vertical slice → tasks → implementation → audit → feedback → release. Используй, когда пользователь начинает новый проект, говорит "запусти пайплайн", "по нашему процессу", "следующая стадия", или когда в проекте есть docs/pipeline/state.md и надо продолжить работу. argument-hint: "[номер стадии или «дальше»]"
Pipeline: проект от идеи до выката
Сегодня: !date +%F. Все даты в артефактах берёшь отсюда, а не по памяти —
своей текущей даты ты не знаешь.
Одиннадцать стадий с жёсткими воротами между ними. Ты ведёшь пользователя по стадиям,
материализуя каждую в файл. Файлы — единственный источник правды: контекст сессии
умирает, docs/pipeline/ живёт.
0. context load — project brief подгружается, не пересказывается
1. idea — что и зачем, в 3–5 предложениях
2. plan + criteria — шаги + явное «готово = ...»
3. risk spikes — только реально неизвестное, код на выброс
4. contracts — модели, сигнатуры, схемы ответов, формат ошибок
5. vertical slice — один сквозной путь end-to-end
6. tasks — атомарные, у каждой свой критерий готовности
7. implementation — по одной задаче за сессию
8. audit — в свежем контексте: тесты + ручные проверки
9. feedback — находки аудита → обратно в brief + decision log
10. release — выкат: пред-запусковые проверки, доступы, бэкапы, откат
Стадии 0–9 — цикл разработки, он повторяется. Стадия 10 проходится не каждый круг, а перед реальной публикацией.
Артефакты
Всё в docs/pipeline/ в корне проекта:
| Файл | Стадия | Природа |
|---|---|---|
state.md | все | текущая стадия + статус ворот. Обновляй каждый раз |
brief.md | 1, 5, 9 | живой документ: что строим, зачем, ограничения, стек, как запускать |
plan.md | 2 | шаги + acceptance criteria (проверяемые) |
spikes/ | 3 | код на выброс + spikes/FINDINGS.md с ответами |
contracts.md | 4 | модели данных, сигнатуры, схемы, конфиг, ошибки |
tasks.md | 6 | атомарные задачи с DoD-чекбоксами |
audit.md | 8 | отчёт аудита свежим контекстом |
decisions.md | 9 (append) | лог решений: дата, решение, альтернативы, почему |
release.md | 10 | что выкачено, куда, чем проверено, как откатить |
Шаблоны — в references/templates.md. Детали по стадиям — в references/stages.md.
Читай нужный раздел stages.md перед началом стадии, а не по памяти.
Правило ворот (нарушать нельзя)
В конце каждой стадии:
- Запиши артефакт на диск.
- Обнови
state.md. - Покажи сжатую сводку: суть + что решили. Не пересказ файла.
- Задай явный вопрос про переход и остановись. Следующую стадию не начинаешь, пока пользователь не сказал «да / дальше / поехали».
Исключение: пользователь явно сказал «не спрашивай, гони до конца». Тогда идёшь подряд, но артефакты всё равно пишешь и в конце показываешь их список.
Правило нулевой стадии
brief.md подгружается, не пересказывается. Прочитал — работай с этим знанием молча.
Пересказ brief пользователю запрещён: он его писал. Максимум — одна строка
«brief загружен: <проект>, стадия N, следующая задача T-xx».
Старт сессии
- Есть
docs/pipeline/state.md? → стадия 0: прочитайbrief.md,state.md, и артефакт текущей стадии. Одна строка подтверждения → продолжай с зафиксированной стадии. - Нет? → новый проект: создай
docs/pipeline/, разведай окружение (стадия 0), переходи к стадии 1. - Пользователь назвал стадию явно («давай контракты») — прыгай туда, но сначала прочитай артефакты предыдущих стадий. Не выдумывай контекст, которого не читал.
Проект, где код уже есть (brownfield)
Пайплайн написан под чистый лист. В существующем проекте стадии те же, но три из них работают наоборот — не проектируешь, а извлекаешь:
- 1 idea. Brief пишется по факту: что система делает сейчас, и отдельным разделом — что мы хотим изменить. Не переписывай замысел автора, ты его не знаешь.
- 4 contracts. Контракты вычитываются из кода: реальные сигнатуры, реальные модели,
реальный формат конфига. Расхождение «как написано» и «как задумано» — находка,
её в
decisions.md, а не молчаливое «исправление». - 5 vertical slice. Слайс уже существует. Вместо написания — запусти имеющийся сквозной путь и покажи вывод. Не запускается — это первая задача, а не повод идти дальше.
Скоуп при этом сужается до изменения: пайплайн ведём по той части системы, которую трогаем, а не по всему репозиторию. Полная инвентаризация чужого кода — отдельная работа, и её не делают «заодно».
Стадии (кратко; развёрнуто — в references/stages.md)
0. Context load. Повторная сессия: подгрузить brief + state молча. Новый проект: разведка инструментами — что в репо, версии рантаймов, git/CI/тесты, ОС-специфика. Не спрашивай пользователя о том, что можешь проверить сам.
1. Idea → brief.md. Вытащи суть вопросами пачкой (AskUserQuestion, не по одному).
Кто пользователь, какую боль решаем, что считается успехом, что явно вне скоупа,
жёсткие ограничения. Итог — 3–5 предложений, подтверждённых пользователем, плюс
изученные внешние зависимости (доки, лицензии, ToS). Кладётся в brief.md.
2. Plan + criteria → plan.md. 3–7 крупных шагов. К каждому — «готово = ...» в форме «дано → когда → тогда». Критерий проверяй вопросом «как я проверю это, не спрашивая мнения?». Нет ответа — переписывай. Отдельно — non-goals.
3. Risk spikes → spikes/. Только то, чего мы не знаем и что может обрушить план.
Один спайк — один вопрос да/нет + факты. Код в spikes/ на выброс: не рефачить,
прод-код его не импортирует. Ответы — в spikes/FINDINGS.md. Спайк убил допущение —
возврат на стадию 2, это успех спайка, а не провал.
4. Contracts → contracts.md. Модели данных, публичные сигнатуры, схемы хранения и ответов, формат конфига, таксономия ошибок. Пиши как код, не прозой. Реализации нет — только формы.
阅读完整来源 ↗