agentik

subochev/agentik

Fork 0

Commit Graph

Author	SHA1	Message	Date
subochev	adcb8f54d6	skills: каталог + ленивая загрузка read_skill Пользовательские инструкции («навыки») живут в указанной папке (AGENTIK_SKILLS_DIR), рекурсивно читаются при старте и попадают в системный промпт в сжатом виде: только имя + краткое описание. Полный текст модель подгружает по требованию, вызывая встроенный инструмент read_skill(name). :skills - SkillCatalog + SkillPrompt (commonMain): рендер секции системного промпта; тело навыка в промпт не течёт. - SkillParser.parseAuto(): теперь читает и opencode-стиль SKILL.md (YAML frontmatter + markdown тело), и голый .yaml/.yml (поля name, description, опц. body). parseOrThrow для strict-путей. - SkillParseError.render(): человекочитаемое описание ошибки для логов и диагностики. - SkillLoader (jvmMain): рекурсивный обход папки, детерминированный порядок (по пути), ошибки отдельных файлов не валят загрузку; дубликаты имён → ошибка, выигрывает первый по пути. :standalone - AgentikConfig.skillsDir + env AGENTIK_SKILLS_DIR. - ChatAgent: параметр skills (SkillCatalog); системный промпт автоматически дополняется секцией «## Навыки» и в working memory сидится вместе с базовым промптом. - При непустом каталоге в tools автоматически добавляется SkillReadTool (имя read_skill) — модель может загрузить полный текст навыка, как обычный LiteTool. - Main.kt: загружает навыки и шумно логирует ошибки загрузки в stderr. * docs - STANDALONE.md: секция «Навыки (skills)», env-переменная в таблице. - Формат SKILL.md (opencode frontmatter) + голый .yaml/.yml. Тесты: :skills jvmTest 34, :standalone jvmTest 69 (новые — состав системного промпта, регистрация read_skill, навыки не утекают в промпт телом).	2026-09-14 00:25:22 +03:00
subochev	f4caab940e	skills: парсер YAML-скилов (opencode-формат) Новый KMP-модуль :skills (9 целей, зеркалит :proto). Парсит скилы в формате opencode: YAML-фронтматтер с name+description, затем markdown body. - SkillFile(name, description, body) — @Serializable результат. - SkillParseError — sealed-иерархия ошибок: Empty, MissingOpeningFence, MissingClosingFence, InvalidYaml, SchemaMismatch, BlankName. - SkillParser.parse(raw): SkillParseResult + parseOrThrow(raw): SkillFile. Обрабатывает BOM, CRLF, имена с двоеточиями (backend:spring:db-base), multiline-YAML, пустое тело; неизвестные ключи фронтматтера игнорирует. - SkillParserTest — 16 тестов, 0 failures. YAML-библиотека — com.charleskorn.kaml 0.104.0 (не JetBrains, интеграция с kotlinx @Serializable). Грабли kaml 0.104: параметр ignoreUnknownKeys переименован в strictMode (инвертирован); missing-required-field прилетает как YamlException, не SerializationException — различаем по сообщению. Проверка: :skills:jvmTest 16/16, :skills:assemble (9 целей) — зелёные.	2026-09-13 21:28:47 +03:00

Author

SHA1

Message

Date

subochev

adcb8f54d6

skills: каталог + ленивая загрузка read_skill

Пользовательские инструкции («навыки») живут в указанной папке
(AGENTIK_SKILLS_DIR), рекурсивно читаются при старте и попадают в
системный промпт в сжатом виде: только имя + краткое описание.
Полный текст модель подгружает по требованию, вызывая встроенный
инструмент read_skill(name).

*:skills
- SkillCatalog + SkillPrompt (commonMain): рендер секции системного
промпта; тело навыка в промпт не течёт.
- SkillParser.parseAuto(): теперь читает и opencode-стиль SKILL.md
(YAML frontmatter + markdown тело), и голый *.yaml/*.yml
(поля name, description, опц. body). parseOrThrow для strict-путей.
- SkillParseError.render(): человекочитаемое описание ошибки для
логов и диагностики.
- SkillLoader (jvmMain): рекурсивный обход папки, детерминированный
порядок (по пути), ошибки отдельных файлов не валят загрузку;
дубликаты имён → ошибка, выигрывает первый по пути.

* :standalone
- AgentikConfig.skillsDir + env AGENTIK_SKILLS_DIR.
- ChatAgent: параметр skills (SkillCatalog); системный промпт
автоматически дополняется секцией «## Навыки» и в working memory
сидится вместе с базовым промптом.
- При непустом каталоге в tools автоматически добавляется
SkillReadTool (имя read_skill) — модель может загрузить полный
текст навыка, как обычный LiteTool.
- Main.kt: загружает навыки и шумно логирует ошибки загрузки в stderr.

* docs
- STANDALONE.md: секция «Навыки (skills)», env-переменная в таблице.
- Формат SKILL.md (opencode frontmatter) + голый *.yaml/*.yml.

Тесты: :skills jvmTest 34, :standalone jvmTest 69 (новые — состав
системного промпта, регистрация read_skill, навыки не утекают в
промпт телом).

2026-09-14 00:25:22 +03:00

subochev

f4caab940e

skills: парсер YAML-скилов (opencode-формат)

Новый KMP-модуль :skills (9 целей, зеркалит :proto). Парсит скилы
в формате opencode: YAML-фронтматтер с name+description, затем markdown
body.

  - SkillFile(name, description, body) — @Serializable результат.
  - SkillParseError — sealed-иерархия ошибок: Empty, MissingOpeningFence,
    MissingClosingFence, InvalidYaml, SchemaMismatch, BlankName.
  - SkillParser.parse(raw): SkillParseResult + parseOrThrow(raw): SkillFile.
    Обрабатывает BOM, CRLF, имена с двоеточиями (backend:spring:db-base),
    multiline-YAML, пустое тело; неизвестные ключи фронтматтера игнорирует.
  - SkillParserTest — 16 тестов, 0 failures.

YAML-библиотека — com.charleskorn.kaml 0.104.0 (не JetBrains,
интеграция с kotlinx @Serializable). Грабли kaml 0.104: параметр
ignoreUnknownKeys переименован в strictMode (инвертирован);
missing-required-field прилетает как YamlException, не
SerializationException — различаем по сообщению.

Проверка: :skills:jvmTest 16/16, :skills:assemble (9 целей) — зелёные.

2026-09-13 21:28:47 +03:00

2 Commits