mirror of
https://github.com/gromlab-ru/svg-sprites.git
synced 2026-07-22 04:40:17 +03:00
S.Gromov
4833b31516
- добавлены синхронные английские и русские инструкции для агентов - расширена сборка документов из Markdown-фрагментов - артефакты перенесены в игнорируемый release output - обновлены README и проверки скиллов
49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
# AI skills
|
||
|
||
Исходники английского и русского скиллов находятся в `skills/svg-sprites/src/{en,ru}/`. Готовые переносимые артефакты генерируются в `skills/artifacts/`, игнорируются Git и упаковываются в ZIP во время release workflow.
|
||
|
||
Обе языковые версии имеют одинаковую структуру:
|
||
|
||
```text
|
||
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
|
||
|
||
В любой собираемый документ можно включать фрагменты:
|
||
|
||
```md
|
||
<!-- include: ./core/10-mode-selection.md -->
|
||
```
|
||
|
||
Include раскрываются рекурсивно, путь считается относительно включающего файла. Циклы, отсутствующие файлы, выход за `skills/svg-sprites/`, frontmatter во фрагментах и нераскрытые include завершают сборку ошибкой. Заголовки не сдвигаются автоматически: entry содержит единственный `# H1`, inline-фрагменты начинаются с `##`.
|
||
|
||
## Локальная сборка
|
||
|
||
```bash
|
||
npm run build:skill
|
||
```
|
||
|
||
Команда собирает и валидирует обе языковые версии, затем записывает их в игнорируемый каталог `skills/artifacts/`. Сборщик проверяет точный список файлов, безопасные пути, symlink, Markdown fences, локальные ссылки и anchors, единственный H1, frontmatter, размер основного документа и отсутствие `TODO`.
|