Agent Skills

Переносимые Markdown-инструкции для любого AI-ассистента. Публикуемый репозиторий:

https://github.com/dataflow-operator/skills

В отличие от MCP, skills не вызывают tools — дают операционные знания из документации и config/samples.

Skills vs MCP

	Agent skills	MCP
Назначение	Deploy, паттерны, resilience	Генерация и валидация YAML
Вызов	IDE или `AGENTS.md` в skills repo	MCP tools
Лучше для	Helm, prod manifests	Черновики YAML, Kafka Connect

Установка

Полная инструкция: skills/INSTALL.md

git clone https://github.com/dataflow-operator/skills.git /tmp/dataflow-skills
mkdir -p .cursor/skills          # или .claude/skills для Claude Code
cp -r /tmp/dataflow-skills/* .cursor/skills/

Cursor: @dataflow, @dataflow-config, …

Claude Code: копия в .claude/skills/ или ссылка на AGENTS.md в CLAUDE.md.

Copilot: ссылка на https://github.com/dataflow-operator/skills в .github/copilot-instructions.md.

Любой агент: AGENTS.md в skills repo.

Skills

Skill	Назначение
`dataflow`	DataFlow vs DataFlowCron
`dataflow-deploy`	Helm, CRD, verify
`dataflow-config`	YAML manifests
`dataflow-fault-tolerance`	Идемпотентность, checkpoint

Сопутствующие файлы: anti-patterns.md, samples-index.md.

Типичный workflow (skills → validate → apply)

dataflow-deploy — оператор установлен (Helm/CRD, webhook в prod).
dataflow / dataflow-config — выбор kind, черновик из skills + samples; проверить anti-patterns.
dataflow-fault-tolerance — pre-apply checklist (upsert, checkpoint, replicas, ack).
Опционально MCP — generate_dataflow_manifest / validate_dataflow_manifest для черновика.

MCP validate — поверхностный

MCP проверяет apiVersion/kind и наличие type + config у source/sink. Это не замена validating webhook. См. MCP.
Server dry-run (admission) — перед созданием ресурса:
```
kubectl apply --dry-run=server -f manifest.yaml
```

Apply и проверка

kubectl apply -f manifest.yaml
kubectl get dataflow,dataflowcron -n <namespace>
kubectl describe dataflow <name>

LLM crawlers

Машиночитаемая карта документации: llms.txt.

JSON Schema (машиночитаемый контракт)

Стабильные URL: /schemas/:

Артефакт	Назначение
`catalog.json`	Allow-list типов; pin `operatorVersion`
`dataflow.json` / `dataflowcron.json`	CRD envelope
`connectors/sources\|sinks/<type>.json`	Типизированный `config` коннектора
`transforms/<type>.json`	Типизированные конфиги трансформаций

Workflow: skills → опционально MCP (shallow) → schemas / kubectl apply --dry-run=server.

Maintainer

Разработка в monorepo dataflow (skills/), публикация в dataflow-operator/skills. Расширения: .cursor/skills/dataflow-* (stubs + maintainer-only — см. SYNC.md).