S.Gromov
4833b31516
- добавлены синхронные английские и русские инструкции для агентов - расширена сборка документов из Markdown-фрагментов - артефакты перенесены в игнорируемый release output - обновлены README и проверки скиллов
2.8 KiB
AI skills
Исходники английского и русского скиллов находятся в skills/svg-sprites/src/{en,ru}/. Готовые переносимые артефакты генерируются в skills/artifacts/, игнорируются Git и упаковываются в ZIP во время release workflow.
Обе языковые версии имеют одинаковую структуру:
src/<language>/
├── SKILL.md
├── core/
│ ├── 00-package-overview.md
│ ├── 10-mode-selection.md
│ ├── 20-project-inspection.md
│ ├── 30-react-next-setup.md
│ ├── 40-generated-contract.md
│ ├── 50-usage-and-colors.md
│ ├── 60-verification.md
│ └── 70-diagnostics.md
└── references/
├── react-vite.md
├── react-webpack.md
├── next-app.md
├── next-pages.md
├── legacy.md
├── migration-1.md
├── programmatic-api.md
└── complex-svg.md
core/ содержит обязательные знания, раскрываемые прямо в итоговый SKILL.md. references/ содержит самостоятельные инструкции для агента по конкретным стекам и редким сценариям. Пользовательские README*.md и docs/{en,ru}/*.md дополнительно копируются в references/upstream/ как вторичный источник полного публичного API.
Композиция Markdown
В любой собираемый документ можно включать фрагменты:
<!-- include: ./core/10-mode-selection.md -->
Include раскрываются рекурсивно, путь считается относительно включающего файла. Циклы, отсутствующие файлы, выход за skills/svg-sprites/, frontmatter во фрагментах и нераскрытые include завершают сборку ошибкой. Заголовки не сдвигаются автоматически: entry содержит единственный # H1, inline-фрагменты начинаются с ##.
Локальная сборка
npm run build:skill
Команда собирает и валидирует обе языковые версии, затем записывает их в игнорируемый каталог skills/artifacts/. Сборщик проверяет точный список файлов, безопасные пути, symlink, Markdown fences, локальные ссылки и anchors, единственный H1, frontmatter, размер основного документа и отсутствие TODO.