| name | ingest |
| description | Процес імпорту (Ingest Workflow) нових матеріалів до персональної бази знань LLM Wiki. Охоплює підготовку метаданих, перенесення файлів з inbox до архівних папок YYYY-MM-DD, оновлення посилань на медіа, аналіз джерел, створення нових або оновлення наявних сторінок концепцій та сутностей, розв'язання суперечностей, каскадні оновлення, оновлення покажчика index.md та журналу активності log.md. Запускайте цей скіл, коли користувач просить імпортувати, обробити або додати нові джерела (ingest, import, add raw source). |
| metadata | {"version":"0.1.0","repository":"https://github.com/BogdanovychA/llm-wiki"} |
Скіл імпорту джерел вікі (Wiki Ingest Skill)
Цей скіл призначений для імпорту нових матеріалів, підготовки метаданих, створення та оновлення сторінок концепцій і сутностей у персональній базі знань LLM Wiki, а також для каскадного оновлення покажчика та логу активності.
Делегування виконання субагенту
- При запуску цього скіла, головний агент обов'язково має делегувати виконання задачі субагенту (наприклад, використовуючи субагента
self). Головний агент створює субагента і передає йому завдання. Субагент виконує весь робочий процес імпорту, описаний нижче, та повертає результат головному агенту.
- Якщо файлів для імпорту декілька, їх необхідно доручати субагентам по черзі (по одному файлу на кожного субагента) та обов'язково послідовно. Субагенти НЕ мають обробляти різні файли одночасно. Головний агент повинен дочекатися повного завершення роботи попереднього субагента та збереження результатів, перш ніж запускати нового субагента для наступного файлу.
[!IMPORTANT]
Після того, як субагент завершив робот та надав звіт, головний агент зобов'язаний перевірити його роботу (чи не було втрачено інформацію, чи вся самодостатня інформація була внесена до нових статей або використана для доповнення наявних, чи додано перехресні посилання, чи здійснено каскадні оновлення тощо) та за необхідності — внести виправлення (на цьому етапі дозволяється редагувати raw).
Для перевірки цілісності посилань, головний агент зобов'язаний запустити скрипт .agents/skills/linter/scripts/lint.py.
Робочий процес імпорту (Ingest Workflow)
Нові матеріали з'являються в каталогах inbox/ та inbox/assets/. Коли користувач просить обробити нове джерело:
1. Підготовка, метадані та імпорт (Preparation, Metadata & Ingestion)
- Визначте поточну дату у форматі
YYYY-MM-DD.
- Для кожного файлу в
inbox/ підготуйте YAML-метадані відповідно до шаблону вхідного джерела (заповніть заголовок, назву, джерело, дату збору тощо) та перейменуйте файл за схемою descriptive-slug.md (обов'язково латиницею, kebab-case).
- Якщо з файлами пов'язані медіафайли або вкладення (у
inbox/assets/), перейменуйте їх латиницею та перенесіть до підкаталогу raw/assets/YYYY-MM-DD/.
- У текстових файлах обов'язково оновіть усі відносні посилання на медіафайли так, щоб вони вказували на нове розташування (наприклад, відповідний відносний шлях
../assets/YYYY-MM-DD/image.png).
- Перенесіть підготовлені та відредаговані текстові файли до підкаталогу
raw/YYYY-MM-DD/.
- Тільки після завершення цього процесу імпорту файли у
raw/YYYY-MM-DD/ та raw/assets/YYYY-MM-DD/ набувають статусу незмінного архіву, подальше редагування, перейменування або видалення якого суворо заборонено.
2. Аналіз
Прочитайте перенесений вихідний документ у новому розташуванні raw/YYYY-MM-DD/descriptive-slug.md. Визначте ключові теми, сутності, дані та зв'язки з наявними сторінками вікі.
3. Логіка вибору при імпорті (Merge vs Create)
Визначте, куди належить новий контент:
- Та сама суть/теза, що й на наявній сторінці $\rightarrow$ Об'єднайте з цією сторінкою. Додайте нове джерело у метадані сторінки (у полі
sources: за відносним шляхом) та оновіть відповідні розділи.
- Нова концепція $\rightarrow$ Створіть нову сторінку у
wiki/concepts/, названу за назвою концепції (обов'язково латиницею, kebab-case), а не файлу джерела. Замініть плейсхолдери тегів у шаблоні на 1–3 тематичні теги, що відображають домен знань цієї концепції (наприклад, ai, physics, software-dev).
- Нова сутність $\rightarrow$ Створіть нову сторінку у
wiki/entities/, названу за назвою сутності (обов'язково латиницею, kebab-case), а не файлу джерела. Замініть плейсхолдери тегів у шаблоні на відповідний тег її субтипу (person, organization, tool тощо).
- Зачіпає кілька тем $\rightarrow$ З одного вихідного джерела можна створювати кілька окремих сторінок концепцій чи сутностей лише тоді, коли ці теми в джерелі висвітлені детально та є самодостатніми. Якщо супутня тема лише згадується побіжно, окрему сторінку чи посилання на неї створювати не потрібно (це запобігає появі битих посилань та порожніх сторінок).
Перевірка на наявність суперечностей: якщо нове джерело суперечить наявній інформації, задокументуйте конфлікт у розділі Суперечності та відкриті питання на обох сторінках та додайте взаємні посилання.
4. Застосування змін та каскадні оновлення (Cascade Updates)
- Створіть/відредагуйте сторінки у
wiki/concepts/ чи wiki/entities/.
- Дублікати посилань: Перед додаванням будь-якого нового посилання до розділу «Джерела та посилання» перевіряйте, чи вже існує посилання з таким самим
target (цільовим шляхом) у цьому розділі. Якщо посилання з таким самим шляхом вже є — не додавайте його повторно.
- Каскадні оновлення: Перевірте, чи впливає нова інформація на інші наявні сторінки вікі. Перевірте файл
wiki/index.md на наявність дотичних тем та оновіть їх відповідно (не забуваючи оновити поле updated: у YAML-заголовку кожного зміненого файлу). Архівні сторінки, як правило, не підлягають автоматичному каскадному оновленню, але їх можна оновити вручну або за запитом, якщо їхні першоджерела були суттєво оновлені.
5. Оновлення покажчика та логу
