onescript
Skill40 starsChanged 41 days agoMITView on GitHub
Пишет пакеты OneScript (packagedef, src/Модули, src/Классы, opm, #Использовать). Использовать при файлах .os, манифесте packagedef, opm, классах и модулях OneScript, без платформы 1С.
In this repository4 other files it gives its agents.
- autumn-cliSkill
- autumnSkill
- onescript-testsSkill
- winowSkill
The file
Files
OneScript
OneScript выполняет BSL из файлов .os без платформы 1С. Синтаксис языка агенту известен. Здесь только то, чем пакет отличается от модуля 1С.
Отличия синтаксиса и грабли платформы: reference.md, pitfalls.md. Тесты: навык onescript-tests.
Каталоги пакета
<имя>/
packagedef
README.md
LICENSE
src/Модули/ фасад, вызов ИмяМодуля.Метод()
src/Классы/ публичные типы, Новый ИмяКласса
src/internal/Классы/ внутренние типы, в packagedef не объявляются
tests/ тесты; каталог fixtures не обязателен
examples/
tasks/ opm run: install.os, test.os, build.osИсходники в кодировке UTF-8 без BOM. Отступ в .os - таб.
Внутренний класс подключается из src/Классы и src/Модули так: #Использовать "../internal".
Имена классов глобальны
Имя класса уникально на весь процесс, каталог internal это не отменяет. СериализаторJson сталкивается с пакетом jason, Валидатор с validate, JWT в crypto с пакетом jwt. Имя привязывай к пакету: СериализаторПроблем, HmacRfc2104. Перед публикацией сверь имена с уже установленными библиотеками.
Модуль доступен как ИмяМодуля.Метод(). Класс создаётся через Новый.
packagedef
Манифест без расширения, в корне. Объявляй только публичные модули и классы. Зависимости рантайма - ЗависитОт, тестовые - РазработкаЗависитОт.
Описание.Имя("demo")
.Версия("0.1.0")
.Описание("Краткое описание")
.ВерсияСреды("2.0.0")
.ВключитьФайл("src")
.ВключитьФайл("tests")
.ВключитьФайл("packagedef")
.ВключитьФайл("README.md")
.ВключитьФайл("LICENSE")
.РазработкаЗависитОт("1commands")
.РазработкаЗависитОт("asserts")
.РазработкаЗависитОт("fs")
.РазработкаЗависитОт("oneunit")
.ОпределяетМодуль("Demo", "src/Модули/Demo.os")
.ОпределяетКласс("DemoValue", "src/Классы/DemoValue.os")
;Точка входа приложения, если она есть, задаётся .ИсполняемыйФайл("src/main.os") и в файле начинается с #Использовать ".".
Библиотеки
Директива стоит в начале файла, до Перем:
#Использовать json- пакет изoscript_modulesили lib;#Использовать "."и#Использовать "../src"- каталог относительно файла.
Стандартный загрузчик: файлы из Классы становятся классами, из Модули - модулями. Имя файла без .os - идентификатор. То же имя стоит в .ОпределяетМодуль и .ОпределяетКласс: #Использовать "../src" берёт имя файла, а после opm install имя берётся из манифеста. Свой загрузчик - package-loader.os с ПриЗагрузкеБиблиотеки, см. reference.md.
Встроенных ЧтениеJSON / ЗаписьJSON хватает для JSON. Пакет json подключай только если он уже есть у соседнего кода.
Команды из каталога пакета
opm run install # tasks/install.os: opm install --dev -l
opm run test # то же, что opm test: оба вызывают tasks/test.os; раннер внутри скрипта
opm run build # tasks/build.os: opm build --out outЛокальный соседний пакет: opm build, затем opm install -f файл.ospx. Общего корневого packagedef у набора библиотек нет: каждый каталог - отдельный пакет.
В корне пакета oscript.cfg с строкой lib.additional=oscript_modules, чтобы локальные зависимости были видны интерпретатору.
Комментарии
Комментарий в src объясняет грабли, без которых следующий разработчик сломает код. Не пиши, что пакет повторяет npm-библиотеку или чужой продукт. Экспортная процедура получает описание параметров и возвращаемого значения. В examples/ допустима шапка «ПРИМЕР / Что делает / Термины». Очевидный пересказ следующей строки не пиши.
В библиотеке под внешнюю спецификацию имена модулей и классов могут быть английскими, методы и переменные русскими. В остальных пакетах имена бери как в соседних файлах.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

