CD pipeline-architecture
Проект, использующий архитектуру Pipeline (сначала объявляется намерение, затем выполняется унифицированно), со структурированными правилами для бизнес-логики чтения и записи. Поддерживает три реализации: Python/FastAPI, TypeScript/Node.js и Flutter/Dart, а также предоставляет дополнительные материалы для Payload CMS и Cloudflare Workers. Используйте, когда проект уже использует эту архитектуру, а задача связана с бизнес-логикой, включая: добавление API endpoint, проектирование процесса записи данных, реализацию проверки разрешений, многошаговую обработку данных, межсистемную запись (БД, внешние API, переменные устройства), журналы аудита или любой рабочий процесс «сначала решение, потом выполнение». Во Flutter-проектах также применимо к бизнес-процессам записи, инициируемым пользователем: UseCase, Command ViewModel, запись в локальную базу данных, вызов серверного API, офлайн-запись и синхронизация outbox. При обнаружении терминов этой архитектуры, таких как pipeline, step, query, mutation, scratch, persistence, StepCommit, StepStop, DataMutation, run_workflow, make_pipeline, runWorkflow, makePipeline, outbox, офлайн-синхронизация, или при изменении бизнес-логики в существующем pipeline-проекте, прочитайте этот Skill и загрузите соответствующие файлы references в зависимости от языка проекта; если проект основан на Payload CMS (существуют payload.config.ts, collections/, custom endpoints, collection hooks), дополнительно загрузите references/payload-cms.md; если проект развернут на Cloudflare Workers (существуют wrangler.toml или wrangler.jsonc), дополнительно загрузите references/cloudflare-workers.md, а также при планировании использования этой архитектуры на Cloudflare для выбора базы данных (Hyperdrive, D1, Durable Objects); если проект на Flutter (существует pubspec.yaml и есть зависимость flutter), загрузите references/flutter.md. Неприменимо для одноразовых скриптов, прототипов, анализа данных, виджетов и чистой логики отображения, или если проект еще не использует эту архитектуру; при явном указании пользователем другого подхода, следуйте указаниям пользователя.
машинный переводПоказать оригиналСкрыть оригинал«採用 Pipeline Architecture（先宣告意圖、後統一執行）的專案，其業務邏輯讀寫流程的結構規範。支援 Python/Fast…»
採用 Pipeline Architecture（先宣告意圖、後統一執行）的專案，其業務邏輯讀寫流程的結構規範。支援 Python/FastAPI、TypeScript/Node.js 與 Flutter/Dart 三種實作，並提供 Payload CMS 與 Cloudflare Workers 的專屬補充。當專案已採用此架構、且任務涉及業務邏輯流程時使用，包含：新增 API endpoint、設計資料寫入流程、實作權限檢查、多步驟資料處理、跨系統寫入（DB、外部 API、裝置變數）、審計日誌，或任何「先決策後執行」的 workflow。在 Flutter 專案中同樣適用於使用者觸發的業務寫入流程：UseCase、ViewModel 的 Command、本地資料庫寫入、呼叫後端 API、離線寫入與 outbox 同步。看到 pipeline、step、query、mutation、scratch、persistence、StepCommit、StepStop、DataMutation、run_workflow、make_pipeline、runWorkflow、makePipeline、outbox、離線同步 等本架構專有名詞，或要在既有 pipeline 專案中修改業務邏輯時，讀取此 Skill 並依專案語言載入對應的 references 檔案；專案若以 Payload CMS 為基底（存在 payload.config.ts、collections/、custom endpoints、collection hooks），額外載入 references/payload-cms.md；專案若部署在 Cloudflare Workers（存在 wrangler.toml 或 wrangler.jsonc），額外載入 references/cloudflare-workers.md，在 Cloudflare 上規劃採用本架構而要決定資料庫（Hyperdrive、D1、Durable Objects）時也要讀取；專案若是 Flutter（存在 pubspec.yaml 且依賴 flutter），載入 references/flutter.md。不適用於一次性腳本、prototype、資料分析、Widget 與純顯示邏輯，或專案尚未採用此架構的情況；使用者明確指示其他做法時，以使用者指示為準。
Проект, использующий архитектуру Pipeline (сначала объявляется намерение, затем выполняется унифицированно), со структурированными правилами для бизнес-логики…
Как процесс D 38/100 · Процесс не доведён — Скилл ссылается на файлы, которых нет в архиве: references/flutter.md
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 6. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - предупреждение
body-longтело SKILL.md ≈ 5662 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: references/flutter.md
Процессный рейтинг: все десять параметров 38/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): references/flutter.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 24, без проверки текущего состояния
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 70Стоимость исполнения. Тело инструкции 5662 токенов
- 100Шаги. Шагов: 83
- 100Согласованность. Имя и обязательные поля на месте
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- low Разделов верхнего уровня: 15. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1012: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- -285 эмодзи в инструкциях: шум для модели
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Структура: 26 заголовков
- +3Пошаговые инструкции: 83 пунктов
- +4Есть примеры (1 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (4 из 4)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 55.