workflow-validate — скилл для Claude Code
Разбирает файлы в src/workflows/ и находит ошибки типизации триггеров и небезопасные повторы шагов. Пригодится перед выкаткой воркфлоу в прод.
npx skills add makenotion/notion-cookbook --skill workflow-validate -a claude-codeЧто делает workflow-validate
Скилл проходит по каждому файлу в src/workflows/ и по модулям, которые эти файлы вызывают. На каждую находку он выдаёт файл, строку, последствия и вариант исправления. Ошибкой считается в том числе отсутствие прямого файла воркфлоу или отсутствие createWorkflow в default-экспорте.
Дальше список строже. Поля событий, зависящие от типа триггера, нельзя использовать без сужения типа. Недеterministic-работа вне awaited-шага, меняющийся между повторами порядок или имена шагов, несериализуемый в JSON результат шага — всё это скилл помечает как ошибку. Запись, чувствительная к повтору, без ключа идемпотентности или защиты от дублей тоже попадает в отчёт.
Внешние сбои, которые код молча глотает, и захардкоженные или залогированные учётные данные скилл тоже считает ошибками. Когда зависимости установлены, он запускает npm run check и npm run build. Без установленных зависимостей эти две команды не отработают, так что сначала ставьте пакеты.
Какие задачи решает
- найти воркфлоу, который не экспортирует
createWorkflowпо умолчанию - поймать обращение к полям события без сужения типа триггера
- убрать недеterministic-код из-за пределов awaited-шага
- добавить ключ идемпотентности к записи, чувствительной к повторам
- вычистить захардкоженные и залогированные учётные данные
Примеры запросов агенту
- Проверь воркфлоу в
src/workflows/и покажи находки с файлом, строкой и исправлением - Найди шаги, результат которых не сериализуется в JSON
- Прогони
npm run checkиnpm run buildи разбери ошибки
Как установить workflow-validate
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow-validate -a claude-code2Вручную: положить файлы
~/.claude/skills/workflow-validate/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/workflow-validate/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow-validate -a codex2Вручную: положить файлы
.agents/skills/workflow-validate/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow-validate -a cursor2Вручную: положить файлы
.cursor/skills/workflow-validate/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install makenotion/notion-cookbook workflow-validate2Вручную: положить файлы
.github/skills/workflow-validate/SKILL.md1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow-validate -a gemini-cli2Командой платформы
gemini skills install https://github.com/makenotion/notion-cookbook --path workers/agents/skills/workflow-validateВручную: положить файлы
.devin/skills/workflow-validate/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow-validate -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о workflow-validate
Как установить workflow-validate в Claude Code?
Выполните npx skills add makenotion/notion-cookbook --skill workflow-validate -a claude-code. После этого файл скилла лежит в ~/.claude/skills/workflow-validate/SKILL.md.
Что делает workflow-validate?
Проверяет файлы в src/workflows/ и вызываемые ими модули: типизацию триггеров, безопасность повторов, сериализуемость результатов шагов и обращение с учётными данными. По каждой находке даёт файл, строку, последствия и исправление.
Какие команды запускает скилл?
npm run check и npm run build, но только когда зависимости уже установлены.
Исходный текст
SKILL.md · MIT
--- name: workflow-validate description: Review Notion Worker Workflows for trigger typing and retry safety. user-invocable: true disable-model-invocation: true --- # Workflow validation Review every file in `src/workflows/` and any modules it calls. Report each finding with its file, line, impact, and fix. Treat these as errors: 1. A Workflow is not a direct file or does not default-export `createWorkflow`. 2. Trigger-specific event fields are used without type narrowing. 3. Non-deterministic work occurs outside an awaited step. 4. Step order or names can change between retries. 5. A step result is not JSON-serializable or later code needs an in-memory mutation. 6. A retry-sensitive write lacks an idempotency key or duplicate guard. 7. External failures are ignored, or credentials are hard-coded or logged. Run `npm run check` and `npm run build` when dependencies are installed.
© makenotion · MIT · makenotion/notion-cookbook
