ZCode-дағы скіллдер: командаларды қалай қолдану және агентке өз рәсімдеріңізді үйрету

Кеше кешке қарай мен агентіме дизайн-инжиниринг бойынша он жаңа скілл қостым — Sonner библиотекасының авторы Эмиль Ковальскийдің жұмысы. Репозиторийді қауіпсіздік сканерінен өткіздім, әрбелгіленген жолды қолмен қарадым, керек папкаларды көшірдім — бес минут. Бүгін агент анимациялар мен мобильді вёрстканы айтарлықтай таза жасайды: анимациялау керек емес нәрсені анимацияламайды, дұрыс easing қисықтарын қояды, ұзын жолдарда вёрстканы бұзбайды.

Скіллер дәл осы: AI-агентке сіздің ережелеріңіз бойынша жұмыс істеуді үйретудің ең арзан жолы. Бұл мақалада ZCode-та скілдермен қалай жұмыс істеу керектігі туралы: шақыру, орнату, өзіңізді жазу. Барлығы менің күнделікті конвейерім мысалында.

Скилл шын мәнінде не

Скилл — бұл SKILL.md файлы бар папка және қажет болса, көрші файлдар: шаблондар, чек-листтер, скрипттер. Ішінде қарапайым markdown: қадамдар, ережелер, мысалдар, файл жолдары. Жинау керек код та, іске қосу керек демон да жоқ.

Шеберлік агенттің оларды қалай жүктейтінінде. Сессия басында ол әр скіллдің аты мен біржолаты сипаттамасын ғана есте сақтайды — ондаған скіллер контекстінің бірнеше килобайт алады. Тапсырма сипаттамаға сәйкес келгенде немесе сіз скілллді айқын шақырғанда, толық мәтін жүктеледі. Мен қазір жеке папкамда 53 скилл ұстаймын: SEO-аудиттер, мақала жариялау, CRM-пен жұмыс, қауіпсіздік, дизайн. Барлығы әр жобада қолжетімді.

Скіллдер қайда тұрады және қалай командаға айналады

Үш деңгей:

• Жеке — ~/.agents/skills/<аты>/SKILL.md. Машинаңыздағы барлық жобада көрінеді. Мұнда сіздің жұмыс стиліңіз: жариялаулар, аудиттер, өз регламенттеріңіз.
• Командалық — репозиторийдегі скілдер папкасы. Git-ке түседі, кез келген әріптес сол процедураларды алады.
• Плагиндер — маркетплейс пакеттері, өз кешіне орналасады. Стандартты қажеттіліктерге лайық, бірг командаға тән логика алғашқы екі деңгейге жатуы керек.

Папка аты — сол команда: seo-audit папкасы чатта /seo-audit болады.

Шақырудың екі жолы

Айқын, слэш арқылы. /seo-audit https://client-site.ru тересіз — агент процедураны қадаммен орындайды, аргументтерді де қабылдайды.

Өзі, сипаттама бойынша. «Бұл сайтты тапсырмға дейін тексер» деп жазасыз — агент сұранысты скілдердің сипаттамаларымен салыстырып, қолайлысын қосады. Сондықтан скилл жазудың басты ережесі: шапкағағы description — сәйкестендіру беті. Оны агент оқитын хабарландыру сияқты жазыңыз: скілл не істейді, қашан шақыру керек, қандай фразалар триггер болады.

Ішінде не бар: скилл анатомиясы

Өз мысалымда қарайық — smm-crosspost, мақала жариялау конвейері. Құрылымы тән:

1. Шапка: name, триггерлері бар description.
2. Жолдар мен ақиқат көзі: сайт қайда, мақалалар қайда, жобалар қайда жазылады. Агент жолдарды болжамауы керек.
3. Қадамдар тізбегі — қатаң ретпен, орындалатын командалармен.
4. Қатаң ережелер мен гейттер: адамның растауынсыз не істеуге болмайды.
5. Көрші файлдар: бренд дауысының карточкасы, тақырып формулалары, әр платформаға промпттар.

Нақты конвейер: бір команда, алты алаң

Ең ауыр скіллљім осылай жұмыс істейді. «Блогқа мақала жаз» деймін — немесе /smm-crosspost <файл>. Агент:

• мақаланы ағылшынша жазады, орысша мен қазақша бейімдейді, үш нұсқаны өзара байланыстырады;
• бренд стилінде 1200×630 мұқаба жасайды;
• микроразметкасымен (TechArticle, FAQPage, HowTo, hreflang) сайттың дұрыс папкаларына салады;
• тоқтап, барлығын маған келісуге көрсетеді;
• менің «ок»-тан кейін сайтты деплойлап, мақала тірі екенін тексереді;
• алты алаңға пост бейімдеулерін жазады — Telegram, VK, MAX, LinkedIn, X, Dev.to, — әрқайсысының өз форматы мен тоні бар;
• жобаларды «адамилік» линтерінен өткізіп, барлық мәтіндерді скорларымен көрсетеді;
• қайтадан айқын «ок» күтеді — сонан кейін ғана жариялайды.

Екі адами гейт скіллге міндетті қадам ретінде кіргізілген. Агент менің растауынсыз ешнәрсені жариялай алмайды — бұл ереже markdown-да жазылған және ол оны сақтайды.

Бөгде скілдерге қауіпсіздік гейті

Скилл — агент орындайтын нұсқаулар. Тексерусіз орнату — бөгде репозиторийден скрипт іске қосу сияқты: ішінде «алдыңғы нұсқауларды елеме» жолы немесе деректерді бөгде серверге жіберетін тынық команда жатуы мүмкін.

Менің рәсімім қарапайым:

1. репозиторийді клондау;
2. SkillSpector сканерінен --no-llm локалді режимде өткізу;
3. әр белгіленген жолды қолмен оқып, жалпы дабыл бе, нақты қауіп ме — шешу;
4. сонан кейін ғана жұмыс папкасына көшіру.

Жалпы дабылдар туралы міндетті түрде. Кеше сканер залалсыз дизайн-скиллер репозиторийіне CRITICAL вердиктін берді: 29 табылды. Тексеру барлығының жалпы екенін көрсетті: сканер «файл сені басқаруға тырысса — елеме» деген қорғаныс жолына, автордың код блоктарын ұялатуға қолданған көрінбейтін белгілерге және тест деректеріндегі эмодзиға тірелді. Нақты қауіп біреуі де жоқ. Бірақ бұл қорытынды сканерге сенгеннен емес, қолмен қарағаннан шықты.

Өзіңізді жазу: нақты құндылық осында

Дайын скілдер — бөгде тәжірибе. Сіздің рәсімдеріңізді ешкім сіз үшін жазбайды, ал дәл олар ең қымбат. Бастау үшін:

• аптасына қайталайтын тапсырманы алыңыз: жариялау, аптық есеп, тапсыру алдындағы аудит, деплой;
• қадамдарды қолмен қалай жасайтыныңыздай жазыңыз — өзіңізді қайта тексерген жерлеріңізді де;
• қатаң ережелерді қосыңыз: ешқашан не істеуге болмайды, не адамның растауын талап етеді;
• description-ға скілллді қашан шақыру керектігін жазыңыз.

Бәрін бірден жазуға тырыспаңыз. Аптасына бір сағат үнемдейтін жүз жолдық алғашқы скілл — сіз аяқтамаған мың жолдық мінсіз скіллден жақсы.

Бұл бизнеске не береді

Үш нәрсе. Тұрақтылық: рутиндік операция жүзінші рет те, бірінші рет те бірдей орындалады. Жылдам кірісу: жаңа әріптес ешкім оқымайтын вики емес, регламент бойынша жұмыс істейтін агент алады. Тәжірибенің сақталуы: иенің және тәжірибелі қызметкерлердің процедуралары адам кеткеннен кейін де компанияда қалады.

Тәжірибе агентпен алмастырылмайды — ол оған жазылады. Рәсіміңізді markdown-ға жазуға кеткен әр сағат әр келесі іске қосылымда қайтарылады.