← К журналу

AI Coding Workflow, Rules и Skills: полный разбор (с примерами)

AI-кодинг & воркфлоу · 2026.08.07 · ~16 мин чтения

Слоистая архитектура Workflow, Rules и Skills для AI-кодинга

На одну и ту же задачу кто-то каждый раз заново объясняет «мы не используем ORM» и «в commit нужен ticket», а кто-то говорит: «следуй project workflow». Разница редко в «интеллекте» модели — она в том, разделены ли Workflow, Rules и Skills на слои и закреплены в Git. В 2026 году все крупные AI-инструменты для кода поддерживают «постоянные ограничения + runbook по запросу + оркестрируемые потоки», но многие по-прежнему сваливают всё в один system prompt. Контекст раздувается, триггеры «плывут», модель перечитывает политики вместо diff. Ниже — проверка: что делает каждый слой, как их комбинировать и примеры для копирования. Асимметричный вывод: водораздел — точки входа и границы исполнения, а не «Claude сильнее GPT на N баллов».

Для пользователей Cursor, Claude Code, GitHub Copilot и аналогов. Workflow (команды, автоматизация, режимы Agent), Rules (.cursor/rules, AGENTS.md, user rules) и Skills (SKILL.md, загрузка по требованию). Единая таблица сравнения, матрица сценариев, рекомендуемые стеки, типичные ошибки, семь шагов внедрения — и почему workflow с Xcode/CI лучше привязывать к macOS-узлу.

1. Зачем AI-кодингу нужны слои Workflow, Rules и Skills

AI-ассистенты для кода — это Agent с доступом к инструментам: читают репозиторий, правят файлы, запускают терминал. Слабость очевидна — каждый новый чат начинается с «амнезии», пока вы снова не вложите в prompt командные нормы. Хуже, когда стиль кода, Git-политику, release-checklist и runbook инцидентов пихают в одну User Rule. Каждое сообщение тащит тысячи токенов политики и вытесняет diff, логи и stack trace.

Лучшая практика 2026 — разделить ограничения и процедуры на три слоя:

  • Workflow: как запускается AI-задача — slash-команды, Plan/Agent, CI-триггеры, удалённая оркестрация Agent.
  • Rules: что всегда верно — стиль, запретные каталоги, требования к тестам, security red lines.
  • Skills: что выполняется по запросу — checklist code review, Xcode release, runbook миграции, обычно в SKILL.md.

Та же логика, что в гиде по режимам разработки Agent: точки входа задают границы поведения, а не таблица параметров модели. Открытый стандарт Skills: Agent Skills Specification; Cursor Rules: документация.

Слои повышают ревьюируемость: изменение Rule влияет на каждый будущий диалог — нужен аккуратный PR. Обновление Skill стоит контекста только при вызове. Смена Workflow — правка command doc или CI job без глобального поведения.

2. Классификация Workflow, Rules и Skills

2.1 Workflow — запуск и оркестрация

Workflow отвечает на вопрос кто и когда поднимает Agent. Типично: команды Cursor вроде /generate-blog, переключение Plan/Agent, /loop в Claude Code, GitHub Actions с AI для починки CI, шлюзы OpenClaw к удалённому Mac. Workflow про триггеры, конечные автоматы, пути артефактов — не про формат одной строки.

2.2 Rules — постоянный слой ограничений

Rules — резидентный контекст: .cursor/rules/*.mdc, Settings, AGENTS.md. Содержание: минимальный diff, запретные зоны, commit-конвенции, язык ответа, обязательные тесты. Rules: короткие, жёсткие, исполняемые. 30 шагов release в Rule не кладут — это Skill.

2.3 Skills — runbook по запросу

Skills — пакеты с отложенной загрузкой: .claude/skills/<name>/SKILL.md или .cursor/skills/<name>/SKILL.md. Agent сначала читает description во frontmatter. Углубление: гид Claude Code Skills: фреймворк из 10 skills.

Запомнить в одну строку
Workflow = как начать; Rules = что нельзя/надо всегда; Skills = как делать класс задач.

3. Сравнительная таблица

Workflow vs Rules vs Skills
ТипВходИсполнениеКонтекстКому
WorkflowКоманды, режимы, CI/webhookМногошаговый Agent, batch, удалённые узлыТолько при триггереTech lead, DevOps
RulesПри открытии проектаОграничения правок, формат, запретыПостоянно — держать leanВсе разработчики
Skills/skill-name или семантикаКонкретные runbookПо запросуКоманды с версионируемыми SOP
CommandsЯвный /commandШаблон promptПри вызовеЛичные шорткаты
HooksСохранение, pre-commitАвто lint/auditБез модели или минимумQuality gates

3.1 Rules vs Skills

Не кладите runbook в Rules
Параметр RulesПостоянно SkillsПо запросу
Типичное содержаниеБез force push, минимальный diffRelease в 7 шагов, security audit
Версионирование.cursor/rules в GitSKILL.md в репо
ТриггерАвтоSlash или семантика
ОбъёмКороче лучше (сотни слов)Длиннее можно, детали в references/

4. Матрица решений

СценарийНастроить сначалаЗаметки
Личный side project3 User Rules → 2 Commands → 1 commit SkillСначала ограничения, на третий раз — Skill
Команда ~10 человекRules проекта → PR Skill → CI WorkflowRules в review; Skills для release
iOS / macOSxcode-release Skill → Rules → Cloud Mac WorkflowArchive требует macOS: сценарии Cloud Mac
Maintainer OSSCONTRIBUTING Rules → docs-sync → security-reviewdisable-model-invocation: true для риска
Startup full-stackAgent Workflow → ci-fix Skill → lean RulesАвтоматизация важнее; Rules — только red lines

5. Рекомендуемые стеки

Стек A — минимум (полдня)

  • 3 User Rules: минимальный diff, без commit без запроса, lint после правок
  • .cursor/rules/blog-writing.mdc только для репо
  • Skill commit для Conventional Commits

Стек B — команда

  • testing.mdc + security.mdc (< 80 строк)
  • Skills code-review, security-review
  • PR: /security-review до merge

Стек C — iOS

  • xcode-release с disable-model-invocation: true
  • Не трогать *.xcodeproj без явной просьбы
  • Локальный M4 или Hashvps Cloud Mac; тренды GitHub Actions macOS

Стек D — контент/docs

  • /generate-blog (brief → zh → i18n)
  • blog-standard-spec-v1.mdc
  • Skills translate-to, seo-optimize

6. Типичные ошибки

  • «Всё в User Rules — проще» → Раздувание prompt; runbook в Skills.
  • «Чем больше Skills, тем лучше» → Конфликт description; до ~10, чёткие границы.
  • «Workflow заменяет CI» → Gates в GitHub Actions / Xcode Cloud.
  • «Rules и Skills в одном файле» → Разная логика ревью и загрузки.
  • «xcode-release без Mac»codesign требует macOS.
  • «Plan Mode = Workflow» → Plan — режим диалога; Workflow — повторяемый, скриптуемый триггер и артефакты.

7. Семь шагов с примерами

  1. Аудит повторяющихся prompt: три раза одна checklist? → Skill.
  2. 3 Rules: только «всегда истинные» red lines.
  3. Каталог Skill: mkdir -p .cursor/skills/code-review или .claude/skills/code-review.
  4. Frontmatter SKILL.md: глагол + сценарий; риск: disable-model-invocation: true.
  5. Определить Workflow: gates в .cursor/commands/*.md.
  6. Коммит в Git: Rules и Skills вместе с кодом.
  7. Привязать узел: shell/Xcode → macOS (локально или Cloud Mac).
Пример 1: Cursor Rule
# .cursor/rules/core.mdc
---
description: Core engineering constraints for this repo
globs: "**/*"
---
- Minimize diff scope; do not refactor unrelated code.
- Never commit unless the user explicitly asks.
- Run tests for touched packages before claiming done.
Пример 2: Skill code-review
# .cursor/skills/code-review/SKILL.md
---
name: code-review
description: Review staged git diff for bugs, security, and test gaps. Use when user asks for review or before PR.
---
1. Run `git diff --staged` (or compare branch to main).
2. Output: Critical / Warning / Suggestion in three sections.
3. Do not auto-fix unless user asks.
Пример 3: gate Workflow
# .cursor/commands/release-ios.md
## Workflow
1. User confirms brief / scope on main branch.
2. Agent runs /test-runner Skill on changed targets.
3. Manual /xcode-release only after CI green.
4. Post changelog; never skip codesign on shared runner.

8. Итог

В 2026 году конкурентоспособность AI-кодинга всё больше зависит от инженерии workflow, а не от одного score модели. Workflow задаёт старт задач; Rules держат линию; Skills превращают checklist сеньоров в версионируемые runbook. Сначала слои — потом дорогая подписка.

Способность модели — не водораздел; водораздел — точки входа и границы исполнения. Cursor Rules · Claude Code Skills · Agent Skills

FAQ

Главное отличие Workflow, Rules и Skills?
Workflow — как запускать и оркестрировать. Rules — постоянные ограничения. Skills — SOP для типов задач. Workflow = кнопка конвейера, Rules = домашние правила, Skills = инструкция.
Смешивать Cursor Rules и Claude Skills?
Концепции схожи, пути разные. Синхронизируйте тело SKILL.md; frontmatter под каждый инструмент.
Какой длины Rules?
Сотни слов на файл, один экран. Больше 5 шагов — в Skill или Workflow doc.
Plan Mode vs Workflow?
Plan Mode — разовое сложное исследование. Workflow — повтор команды с gates: release, i18n, fix CI.
Коммитить конфиг проекта в Git?
Да. .cursor/rules, .cursor/skills, .claude/skills, .cursor/commands в репозитории — clone наследует setup.
Зачем Cloud Mac для Xcode workflow?
Archive, codesign и xcodebuild требуют нативного macOS. Cloud Mac — узел 7×24 по SSH, ноутбук можно не оставлять включённым.

Чтобы workflow работал, нужен стабильный узел исполнения

AI-workflow с Xcode-сборками, Fastlane или демонами launchd требуют нативного macOS. Hashvps Cloud Mac mini M4 даёт SSH/VNC, выделенный IPv4 и чистую среду с Homebrew—те же .cursor/skills/ и Rules ведут себя одинаково локально и в облаке, Agent не привязан к железу ноутбука.

Если вы подключаете Skills к iOS-релизу или CI, Hashvps Cloud Mac — экономичный узел исполнениясмотреть тарифы и пустить workflow на удалённом хосте 7×24.

Hashvps · Mac Cloud

Стабильные Mac-узлы для воркфлоу

Cloud Mac mini M4, нативный macOS и SSH — для AI Agent с Xcode.

На главную
Акция