跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
安全

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.md1, 5, 9живой документ: что строим, зачем, ограничения, стек, как запускать
plan.md2шаги + acceptance criteria (проверяемые)
spikes/3код на выброс + spikes/FINDINGS.md с ответами
contracts.md4модели данных, сигнатуры, схемы, конфиг, ошибки
tasks.md6атомарные задачи с DoD-чекбоксами
audit.md8отчёт аудита свежим контекстом
decisions.md9 (append)лог решений: дата, решение, альтернативы, почему
release.md10что выкачено, куда, чем проверено, как откатить

Шаблоны — в references/templates.md. Детали по стадиям — в references/stages.md. Читай нужный раздел stages.md перед началом стадии, а не по памяти.

Правило ворот (нарушать нельзя)

В конце каждой стадии:

  1. Запиши артефакт на диск.
  2. Обнови state.md.
  3. Покажи сжатую сводку: суть + что решили. Не пересказ файла.
  4. Задай явный вопрос про переход и остановись. Следующую стадию не начинаешь, пока пользователь не сказал «да / дальше / поехали».

Исключение: пользователь явно сказал «не спрашивай, гони до конца». Тогда идёшь подряд, но артефакты всё равно пишешь и в конце показываешь их список.

Правило нулевой стадии

brief.md подгружается, не пересказывается. Прочитал — работай с этим знанием молча. Пересказ brief пользователю запрещён: он его писал. Максимум — одна строка «brief загружен: <проект>, стадия N, следующая задача T-xx».

Старт сессии

  1. Есть docs/pipeline/state.md? → стадия 0: прочитай brief.md, state.md, и артефакт текущей стадии. Одна строка подтверждения → продолжай с зафиксированной стадии.
  2. Нет? → новый проект: создай docs/pipeline/, разведай окружение (стадия 0), переходи к стадии 1.
  3. Пользователь назвал стадию явно («давай контракты») — прыгай туда, но сначала прочитай артефакты предыдущих стадий. Не выдумывай контекст, которого не читал.

Проект, где код уже есть (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. Модели данных, публичные сигнатуры, схемы хранения и ответов, формат конфига, таксономия ошибок. Пиши как код, не прозой. Реализации нет — только формы.

阅读完整来源 ↗