AC pipeline-architecture
Проект, использующий архитектуру конвейера (сначала объявление намерения, затем унифицированное выполнение), с нормами структуры для потоков чтения/записи бизнес-логики. Поддерживает две реализации: Python/FastAPI и TypeScript/Node.js, а также предоставляет дополнения для базового проекта Payload CMS. Используется, когда проект уже использует эту архитектуру, а задача связана с потоком бизнес-логики, включая: добавление конечной точки API, проектирование потока записи данных, реализацию проверки разрешений, многошаговую обработку данных, запись между системами (БД, внешние API, переменные устройства), журналы аудита или любой рабочий процесс «сначала решение, потом выполнение». При обнаружении специфичных для этой архитектуры терминов, таких как pipeline, step, query, mutation, scratch, persistence, StepCommit, StepStop, DataMutation, run_workflow, make_pipeline, или при изменении бизнес-логики в существующем конвейерном проекте, прочитайте этот навык и загрузите соответствующие файлы references в соответствии с языком проекта; если проект основан на Payload CMS (существуют payload.config.ts, collections/, custom endpoints, collection hooks), дополнительно загрузите references/payload-cms.md. Неприменимо для одноразовых скриптов, прототипов, чистого фронтенда, анализа данных или когда проект еще не использует эту архитектуру; если пользователь явно указывает другой подход, следуйте указаниям пользователя.
машинный переводПоказать оригиналСкрыть оригинал«採用 Pipeline Architecture（先宣告意圖、後統一執行）的專案，其業務邏輯讀寫流程的結構規範。同時支援 Python/Fa…»
採用 Pipeline Architecture（先宣告意圖、後統一執行）的專案，其業務邏輯讀寫流程的結構規範。同時支援 Python/FastAPI 與 TypeScript/Node.js 兩種實作，並提供 Payload CMS 基底專案的專屬補充。當專案已採用此架構、且任務涉及業務邏輯流程時使用，包含：新增 API endpoint、設計資料寫入流程、實作權限檢查、多步驟資料處理、跨系統寫入（DB、外部 API、裝置變數）、審計日誌，或任何「先決策後執行」的 workflow。看到 pipeline、step、query、mutation、scratch、persistence、StepCommit、StepStop、DataMutation、run_workflow、make_pipeline 等本架構專有名詞，或要在既有 pipeline 專案中修改業務邏輯時，讀取此 Skill 並依專案語言載入對應的 references 檔案；專案若以 Payload CMS 為基底（存在 payload.config.ts、collections/、custom endpoints、collection hooks），額外載入 references/payload-cms.md。不適用於一次性腳本、prototype、純前端、資料分析，或專案尚未採用此架構的情況；使用者明確指示其他做法時，以使用者指示為準。
Проект, использующий архитектуру конвейера (сначала объявление намерения, затем унифицированное выполнение), с нормами структуры для потоков чтения/записи…
Как процесс C 50/100 · Есть пробелы — слабые места: результат и критерий готовности, когда включается, входы и предусловия
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 5. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда")
Процессный рейтинг: все десять параметров 50/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 16, без проверки текущего состояния
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 60Инструменты и файлы. Используются инструменты (web, python), но во frontmatter они не объявлены
- 100Шаги. Шагов: 60
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 3878 токенов
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- low Разделов верхнего уровня: 15. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- -249 эмодзи в инструкциях: шум для модели
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 614 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 26 заголовков
- +3Пошаговые инструкции: 60 пунктов
- +4Есть примеры (1 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (3 из 3)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 74.