t8nax

onboard

"Взять проект под кит: завести базу знаний, связать с ней основную копию и заполнить базу разговором с оператором. Для каталога, который под китом ещё не числится, — пустой папки нового проекта или существующего репозитория. Звать словами «новый проект», «поставь кит на этот проект», «свяжи с базой знаний» или /onboard. Не для ведения работы — это /drive, и не для ремонта разорванной связи."

t8nax 0 Updated 4w ago
GitHub

Install

npx skillscat add t8nax/agents-kit/onboard

Install via the SkillsCat registry.

SKILL.md

Навык: onboard

Довести каталог от «ничего нет» до связанной копии с непустой базой. Дальше — /drive, и каркас проекта уже его задача со своим критерием.

Скрипты и раскладка кита: ..\..\scripts\ и ..\..\reference\base-layout.md от каталога этого скилла.

1. Где мы сейчас

Каталог не под git — git init.

Каталог под git — link.ps1 -Path <копия> без -Base, прочитать отчёт:

  • связь двусторонняя — кит уже стоит: сказать и отправить в /drive;
  • указатель разорван, это не база кита, связь односторонняя — это разрыв, а не онбординг: показать отчёт и остановиться; чинит оператор;
  • указателя нет — дальше.

Каталог не корень репозитория — спросить оператора, брать под кит репозиторий целиком или только этот каталог; при ответе «каталог» link.ps1 зовётся с -Scope Directory.

2. Разговор

Раскладка базы читается до разговора, вопросы — по ней.

Спрашивается то, чего в репозитории нет. Пустая папка — всё. Есть код — сначала прочитать его и спросить остаток; выводимое из кода в базу не идёт.

Не больше трёх вопросов блоком, каждый с черновиком ответа. Ответа нет — строки нет.

3. Завести базу и связать

База лежит рядом с корнем репозитория и вне его. Предложить путь <родитель корня репозитория>\<имя папки>-knowledge и тем же вопросом — имя проекта, как его зовёт команда, с черновиком из имени папки (order-service → Order Service), и буквы, которыми проект нумерует бэклог, с черновиком из имени проекта (Order Service → ORD); какие буквы годятся — ..\..\reference\backlog-record.md.

  1. base-init.ps1 -Path <база> -Name "<имя проекта>" -Prefix <буквы> — каркас и репозиторий базы.
  2. link.ps1 -Base <база>, а под кит берётся каталог — link.ps1 -Base <база> -Scope Directory; обе стороны связи пишет он, agents-kit.json руками не правится.

4. Записать и закоммитить

Ответы разложить по раскладке через тест входа; решения — по файлу decisions/ на область, со строкой когда:. Флоу пишется с оператором; не готов он — флоу остаётся без стадий, и /drive спросит его на первой задаче. Коммит базы явными путями, без кода.

5. Передать работу

Сказать: связь поднята, база заполнена вот этим. Знание приедет со следующей сессии — хук отработал, когда копия ещё не была связана. Первая задача — /drive.

Чего не делать

  • Не чинить разорванную связь и не заводить вторую базу вместо ремонта.
  • Не разворачивать каркас проекта и не коммитить код.