agentleFS
yellow-hammeryellow-hammer/skills-onescript/skills/onescript/SKILL.md

onescript

Skill40 starsChanged 41 days agoMITView on GitHub

Пишет пакеты OneScript (packagedef, src/Модули, src/Классы, opm, #Использовать). Использовать при файлах .os, манифесте packagedef, opm, классах и модулях OneScript, без платформы 1С.

The file

Files
SKILL.md

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/ допустима шапка «ПРИМЕР / Что делает / Термины». Очевидный пересказ следующей строки не пиши.

В библиотеке под внешнюю спецификацию имена модулей и классов могут быть английскими, методы и переменные русскими. В остальных пакетах имена бери как в соседних файлах.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.